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ABSTRACT 

Selected pages from the nine research editions of the UNIX 9 Programmer's 
Manual illustrate the development of the system. Accompanying commentary 
recounts some of the needs, events, and individual contributions that shaped this 
evolution. 



1. Introduction 

Since it began at the Computing Science Research Center of AT&T Bell Laboratories in 
1969, the UNIX system has exploded in coverage, in geographic distribution and, alas, in bulk. It 
has brought great honor to the primary contributors, Ken Thompson and Dennis Ritchie, and has 
reflected respect upon many others who have built on their foundation. The story of how the system 
came to be and how it grew and prospered has been told many times, often embroidered almost into 
myth. Still, aficionados seem never to tire of hearing about how things were in that special circle 
where the system first flourished. 

This collection of excerpts from the nine editions of the research UNIX Programmer's Manual 
has been chosen to illustrate trends and some of the lively give-and-take— or at least the tangible 
results thereof— that shaped the system. It is a domestic study, aimed only at capturing the way 
things were in the system's original home. To look further afield would require a tome, not a report, 
and possibly a more dispassionate scholar, not an intimate participant. The raw readings are supple- 
mented by my own recollections as corrected by the memories of colleagues. 

The collection emphasizes development up to the Seventh Edition (v7*) in 1979, providing 
only occasional peeks ahead to v8 and v9. Although people elsewhere in Bell Labs and in Berkeley 
made significant contributions before v7, it was really with v7 that the system fledged and left the 
research nest. V7 was the first portable edition, the last common ancestor of a radiative explosion to 
countless varieties of hardware. Thus the history of v7 is part of the common heritage of all UNIX 
systems, while v8 and v9 will be more or less foreign to many readers. Moreover v7 happened long 
enough ago to be viewed with reasonable perspective. 

The system was already well developed before vl appeared in 1971. And not until v4 was the 
system first described in public [12], [13]. The technical side of the development from a paper exer- 
cise through a fully self-supporting model on a DEC PDP-7 to implementation on a series of PDP- 
11s has best been told by Ritchie in [11]. In his Turing Award lecture Ritchie reflected further 
upon the nature of the lab environment that fostered the development [10]. 

To keep the size of this report in bounds current versions of manual pages are rarely shown; 

* For brevity I have adopted the designation vn for the nib Edition. This usage sprang from a colloquial tendency 
to refer to the Sixth and Seventh Editions as Versions 6 and 7. which inevitably led to the nickname v8 for the 
Eighth Edition. The rest followed. 



interested readers will be familiar with and doubtless own the manual for v7 or one of its many des- 
cendants, such as System V or BSD. Many of the pages were chosen to show things happening, and 
some to show foibles. Enduring central features have been correspondingly slighted. By overlooking 
the news (or nonnews) about permanent things, I have unfortunately also overlooked the news (or 
nonnews) about just how well Thompson and Ritchie wrought. As many people have observed, the 
success of the UNIX system often owes as much to what it does not have as what it does. In the 
same way, lasting truths are likely not to be found in this story about its changes. Those I have 
tried to tell elsewhere [7]. 

In condensing the flow of events into comprehensible and compact history, I have largely over- 
looked, if indeed I could even have recognized, the myriad of borrowings of style and viewpoint and 
the continual interplay of criticism and code-dabbling that knit a cohesive gestalt. Without the 
vision of Ken Thompson, UNIX would not have come into existence; without the insight of Dennis 
Ritchie, it would not have evolved into a polished presence; without the imagination of Mike Lesk 
and popularizing touch of Brian Kernighan, it would not have acquired the extroverted personality 
that commands such widespread loyalty. But without any one of the people whose contributions are 
cited here, neither UNIX nor the work of others in the group would be the same. 

1.1. The People 

Up to v7 the dramatis personae were relatively few. Never officially recognized in any organ- 
ization chart, the group coalesced voluntarily. Most of these original contributors are still with the 
Computing Science Research Center or its divestiture-induced clone at Bell Communications 
Research. 

Ken Thompson began the construction from the ground up based on a file system model 
worked out with Ritchie and Rudd H. Canaday. He made processors for B, bas, and Fortran 
besides the operating system proper, and personally installed customized versions of UNIX for early 
clients as far away as Georgia. With Ritchie, Ken wrote the first shell and piles of utilities includ- 
ing ed, roff, sort, grep, uniq, plot, sa, and dd. He is also known for creative decompiling of mystery 
code. As if all this weren't enough, he has at the same time written circuit-optimizing tools, switch- 
ing and network code, C compilers, and the basic software for several special-purpose machines, 
especially the chess champion, Belle. 

Dennis M. Ritchie, best known as the father of C, joined Ken very early on. Dennis contri- 
buted basic notions such as fork-exec and set-userid programs. They jointly wrote the fc compiler 
for Fortran IV. The first debugger db and the definitive ed were Ritchie's, as was the radically new 
stream basis for IO in v8 and much networking software. With Steve Johnson he made UNIX port- 
able, moving the system to an Interdata machine (v7). The names of Ritchie and Thompson may 
safely be assumed to be attached to almost everything not otherwise attributed. 

Joe (Joseph F.) Ossanna, with the instincts of a motor pool sergeant, equipped our first lab 
and attracted the first outside users. Joe's nroff and troff indelibly shaped UNIX word processing 
and typesetting. 

Bob (Robert) Morris stepped in wherever mathematics was involved, whether it was numerical 
analysis or number theory. Bob invented the distinctively original utilities typo, and dc-bc (with 
Lorinda Cherry), wrote most of the math library, and wrote primes and factor (with Thompson). 
His series of crypt programs fostered the Center's continuing interest in cryptography. 

Doug (M. Douglas) Mcllroy exercised the right of a department head to muscle in on the ori- 
ginal two-user PDP-7 system. Later he contributed an eclectic bag of utilities: tmg for compiler 
writing, speak for reading text aloud, diff, and join. He also collected dictionaries and made tools to 
use them: look (v7, after a model by Ossanna), diet (v8), and spell (v7). 

Lorinda L. Cherry collaborated with Morris on dc-bc and typo. Always fascinated by text 
processing, Lorinda initiated eqn and invented parts, an approximate parser that was exploited in 
the celebrated Writer's Workbench®, ww6(v8). 

Steve (Stephen C.) Johnson's yacc reduced Al (Alfred V.) Aho's expertise in language theory 
to practice. Upon that base Steve built the portable C compiler that was used to port the system 
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itself and to evaluate candidate instruction sets for unbuilt machines. Johnson made the first spell, 
worked on computer algebra, and devised languages for VLSI layout. 

. Lee E. McMahon's linguistic insight fostered the characteristic text-processing— as distinct 
from text-formatting— capabilities of the system. He wrote comm. qsort, sed, the current grep. and 
the concordance-builders index for English and cref for C. After an early fling with cu and an 
influential laboratory switching system done with Condon, Morris, Thompson, Chuck (Charles B.) 
Haley and Cherry, Lee became the prime software architect for Sandy Fraser's Datakit* switch. 

Brian W. Kernighan, expositor par excellence, coined the name UNIX, popularized the tools 
philosophy [6], wrote the best tutorials, and became a prolific inventor of specialized "little 
languages": ratfor, eqn, awk and pic. The Center's typesetting guru since the untimely death of Joe 
Ossanna, Brian produced the current "device-independent" version of troff and postprocessors for 
particular hardware. 

Steve (Stephen R.) Bourne arrived at the time of v6, bringing Algol 68 with him. His defini- 
tive programs, the debugger adb, and the "Bourne shell," although written in C, looked like Algol 
68: Steve wrote DO-OD and BEGIN- END instead of { and }. Bourne also contributed macro con- 
structs to the UNIX Circuit Design System (see 4.3). 

Mike (Michael E.) Lesk, with a prescient market instinct, made text formatting accessible to 
the masses with the generic macros — ms, which were to troff what a compiler is to assembly 
language. He rounded out -ms with the preprocessors tbl for typesetting tables and refer for 
bibliographies. He also made the lex generator of lexical analyzers. Eager to distribute his 
software quickly and painlessly, Mike invented uucp, thereby begetting a whole global network. 
Over the years, often helped by Ruby Jane Elliott, he initiated fascinating on-line audio, textual, 
and graphical access to phone books, news wire (apnews, v8), weather (v8), and UNIX instruction 
{learn, with Kernighan, v7). 

Stu (Stuart M Feldman implemented, with Andy (Andrew D.) Hall, the efl preprocessor to 
sugar Fortran with PL/I-ish syntax. He wrote the pi Fortran compiler single-handedly and 
invented the famous make. A man of taste and culture, Stu exhibited both in his underground clas- 
sic on UNIX style [31. 

Peter J. Weinberger has moved effortlessly among number theory, databases, languages, and 
networking. Weinberger boasts the middle initial of awk, the 10 library for pi ', and a famous 
visage (see FACED, page 14). In v8 and v9 appeared an unbounded precision arithmetic package 
mp, a fast factoring program qfactor, a B-tree library cbt, and a new code generator for C, all 
Peter's work. Above all, his network file system bound a stable of machines together into a logically 
homogeneous system (v8). 

Sandy (A. G.) Fraser devised the Spider local-area ring (v6) and the Datakit switch (v7) that 
have served in the lab for over a decade. Special services on Spider included a central network file 
store, nfs, and a communication package, ufs. Datakit, a "central office" for data communication, 
gave added impetus to research in distributed computing. Fraser undertook the Unix Circuit Design 
System (see CDL in section 4.3) to support his hardware projects. 

Joe (Joseph H.) Condon, physicist and circuit designer extraordinaire, although not usually 
listed as an "author" of UNIX, is an indispensable presence among the group. He wrote much of 
the Unix Circuit Design System, including sophisticated wire-routing algorithms. He designed 
superfast specialized machines, including the chess machine Belle (with Thompson), domesticated 
real telephone switches to our laboratory environment for the experiments of McMahon and others, 
and made unusual connections to the telephone system that, among other things, let our lab com- 
puter detect and announce incoming voice calls. 

Al (Alfred V.) Aho's unstintingly given insight into language theory and algorithms shows up 
in programs by many peoplevsuch as yacc, lex, cc, the Writer's Workbench, and the screen editor 
sam, as well as in his own awk, egrep, and fgrep. 

Greg (Gregory L.) Chesson pursued all aspects of computer-to-computer communication: mul- 
tiplexing with mpx (v7), flow-controlled channels with con (v7) and dcon, and protocols, including 
one used by uucp. The first kernel- and user-level software for Datakit was his. 



Many other people contributed. By the time of v4 the role of provider to the by then sizable 
clientele within Bell Labs had been assumed by Berk (Berkley A.) Tague and his UNIX Support 
Group, thereby guaranteeing the future of the system. Shortly thereafter the Programmer's Work- 
bench project undertook to adapt the system to support large software efforts. Their concern with 
administrative tools led to somewhat differently flavored utilities such as find (v5), cpio (v7), and 
sees. Joe (Joseph F.) Maranzano of the USG and Dick (Richard C.) Haight of PWB became de 
facto adjunct members of the research group. Haight contributed find, cpio, and expr, all in v7. 
Ted (Theodore A.) Dolotta of PWB did much to refine the manual. 

Some USG and Computer Center people eventually joined the Computing Science Research 
Center to bring order to our zoo of equipment: Andy (Andrew R.) Koenig conceived and built asd, 
the automatic software distribution system that keeps v9 current across about 50 different comput- 
ers, and snocone, a preprocessor to sugar the syntax of Snobol into a structured language. Fred 
(Frederick T.) Grampp's unrivaled practical experience in computer security shows up in subtle 
countermeasures now routinely used in our systems. A thorough security audit program of his ulti- 
mately became the administators' tool quest. Ed (Edward J.) Sitar, with devotion worthy of 
Ossanna, saw to it that the hardware actually worked, keeping twenty machines housed and 
powered, and suppliers on their mettle. 

Tom (Thomas B.) London and John F. Reiser ported v7 to the VAX and introduced paging. 
Their V32 system, as filtered through Berkeley, became the progenitor of almost all research UNIX 
systems. Reiser later contributed a peerless compile-and-execute bitblt for the Teletype 5620. 

People who joined the research center after v7 led development in new directions. Bart N. 
Locanthi designed the bitmapped terminal known variously as "jerq," "Blit," and Teletype 5620. 
He programmed it, too: from graphic primitives, such as the crucial bitblt, up to a multiterminal 
maze war game. Rob Pike supplied a multiprogramming system, host-terminal communications, 
mouse control, and support for overlapping virtual terminals (mpx, later mux). Pike's system fos- 
tered fascinating programs by many people, of whom I shall mention only a few (v8). Pike himself 
built visual editors, culminating with sam (v9), which went well beyond the command capability of 
vi— seemingly with no more mechanism than the venerable ed. (Rob's simplifying touch is also visi- 
ble in the shell, in p for paginating, and in his recasting of Chesson's remote execution software, all 
in v8.) 

The Blit terminal attracted Mark S. Manasse who (with Pike) invented lens, an algorithmi- 
cally ingenious bitmap magnifier, and tek4014, a disarmingly faithful simulator of Tektronix termi- 
nals. Luca Cardelli contributed an icon builder, annoying crabs that devour screen images, and the 
catchy vismon that posts icons of the senders of incoming mail. Tom (Thomas A.) Cargill did a 
monumental multiview debugger pi, thoroughly exercising the object-oriented capabilities of Bjarne 
Stroustrup's C++. Tom (Thomas J.) Killian made a font editor jf and programs to save and print 
bitmap images (blitblt, thinkbli) that led in turn to can, a comprehensive suite of laser-printer 
software built from the ROM up. For the UNIX system itself, Killian invented the important 
/proc file system that contains core images of all running processes. 

Dave (David L.) Presotto tamed networks. His upas brought some order to a Babel of mail 
addresses and his ipc primitives provided a common basis for communication and remote file access 
via Internet, Ethernet, and Datakit. Bill (William T.) Marshall, who shares principal Datakit 
software responsibility with McMahon, wrote basic protocol code. These protocols merit unusual 
confidence: their correctness was mechanically verified by Gerard Holzmann. 

Andrew G. Hume wrote proof to put troff on your screen (v8, begun by Locanthi), parts of 
the UNIX Circuit Design System (v9), mk to supplant make (v9), and a remote backup service 
(v9). Norman Wilson shares with Ritchie the honors of reigning guru. He has been instrumental 
in porting v8 to a Cray and in rationalizing system configuration procedures. Waging a personal 
battle against entropy, Wilson rectified countless infelicities, gli/.ches, and blunders in the software 
and the manual, always making things shorter and simpler as he did so. 
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1.2. The Manual 

During the system's first two years one literally had to work beside the originators to learn it. 
But the stock of necessary facts was growing and the gurus' capacity to handle apprentices was lim- 
ited. As they wished to spread the good news about their marvelous system, a manual became a 
necessity. Ritchie one day set forth the first "man page" in a format that has stood the test of time. 
The terse, yet informal, prose style and alphabetic ordering encouraged accurate on-line documenta- 
tion: it was not a big deal to decide how and where to describe changes as they happened. The for- 
mat was popular with initiates who needed to look up facts, albeit sometimes frustrating for 
beginners who didn't know what facts to look for. 

The absence of any "logical" grouping of facilities was a deliberate result of discussion. (As 
encyclopedists have always known, the relationships among knowledge are too various to force into 
rational linear order.) Retrievability and honesty were the prime concerns. The refreshing BUGS 
notes served as a constant reminder of areas for improvement. 

The first manual was duplicated for a very small coterie. In order to channel queries directly 
to the horses' mouths, authorship was attributed to individuals. Later, as authorship diffused, on the 
principle of "You touched it last; it's yours," authorship was attributed only in the segregated 
chapter of unofficial "user maintained programs." Beginning with v7, this back-of-the-bus chapter 
was reserved for games. 

As the system was elaborated, peer pressure in the research group caused rough places to be 
smoothed, vague ideas to be sharpened, and feeble programs to be extinguished. Most details of the 
constant questioning and experimentation during the early period of rapid change are long forgotten, 
as are hundreds of transitory states that were recorded in the on-line manual. From time to time, 
however, a snapshot was taken in the form of a new printed edition. Quite contrary to commercial 
practice, where a release is supposed to mark a stable, shaken-down state of affairs, the very act of 
preparing a new edition often caused a flurry of improvements simply to forestall embarrassing 
admissions of imperfection. 

1.3. The Events 

Among the more memorable minirevolutions that the system experienced were 

— The appearance of pipes elevated standard-in-standard-out design to the status of a "philoso- 
phy" (v3). Old software was gradually brought into line (see SORT on page 7). 

— Grep (Thompson, v4) ingrained the tools outlook irrevocably. Already visible in utilities such 
as wc (Ossanna, vl), cat, and uniq (v3), the stream-transformation model was deliberately 
followed in the design of later programs such as tr (Mcllroy, v4), m4 (Kernighan and Ritchie, 
v7), sed (McMahon, v7), and a flurry of language preprocessors. 

— Conversion to C (v4) made basic abstractions clearer. Assembly language and magic con- 
stants gradually declined from the status of the "real truth" (v4) to utterly forgotten (v8). 

— The novel style of eqn influenced the design— even the conception— of a still growing genera- 
tion of special purpose languages (v5) . 

— The move away from PDP-lls caused a further push for portable abstractions. The main visi- 
ble symptom was a proliferation of include files (v7). 

— The Bourne shell almost overnight drove out the simple old shell. A PWB shell had made 
shell programming useful; the Bourne shell made it an essential part of UNIX programming 

(v7). 

"» Mike Lesk's uucp gave operational meaning to the phrase "UNIX community" (v7). News 
now travels electronically among users all over the world; and technical collaborations proceed 
between distant locations almost as easily as within one building. 

— Direct network connections among our computers began with Sandy Fraser's Spider network 
and became widespread with Datakit (Chesson and Ritchie, v7). Datakit and Ritchie's 
streams (v8) made possible Peter Weinberger's network file system, Andy Koenig's automatic 
software distribution, and Dave Presotto's connections to diverse networks. As a result "the" 



research machine is no longer identifiable; users can— and do— work on one or more of two 
dozen computers simultaneously. 

- Bitmapped terminals operating under Rob Pike's "jerq" software caused a quantum jump in 
personal multiprogramming and inspired intriguing new programming styles (v8). 

The early editions came in quick succession. Later the interval between editions increased for 
several reasons. First, most of the system was mature and stable. Second, from the standpoint of 
the manual, much research was subliminal. For example, the biggest system changes from v6 to v7 
to v8— portability and streams— barely affected the manual. Third, the need for timely printing 
diminished as other organizations became responsible for distribution. And fourth, as the system 
grew to encompass facilities beyond any individual's ken,* the task of organizing an ever-growing 
manual for printing became increasingly daunting. 

The UNIX lab has always been an exciting place to work. As I recorded this summary, I 
recalled vivid individual moments when new ideas or startling combinations of old ideas flashed 
through the lab, when programming met theory and vice versa, and when advances on many simul- 
taneous fronts built upon and reinforced one another. I was forcibly reminded over just how wide a 
spectrum of activities and interests each member of the group has ranged and how freely and 
without fanfare collegial help has flowed among them. The primary dividends to the participants 
have been the fun of doing, the joy of accomplishment and the satisfaction of seeing one's handiwork 
used. Intellectual proprietorship and physical ownership count for little; there's more than enough 
of both for everyone. 



2. Primary Commands 
CAT (vl page 16t) 

Cat is probably the oldest and best-known of all distinctively UNIX utilities. The current (v9) 
description scarcely differs from that in vl. On the PDP-7 there had been a program pr for copying 
a single file to the terminal. Having been subsumed by cat, pr was retired and its name was recy- 
cled. 

Since cat was the prototypical filter, people were tempted to pile on options for other func- 
tions. Thus cat was pressed into service to block output into 512-byte chunks. That in turn led to 
cat -u (v7) to turn the feature off. This dismal admission that byte streams might not always be 
pure had been overcome by the time of v8. In other circles the chastity of cat was violated more 
severely; see Pike's essay on cat -v{9] . 

CP (vl page 17, v5 page 18) 

The war-horse utility cp and its close relative mv originally worked on lists of pairs. Such 
lists, however, could not be generated by the shell's * convention. All too often mistyped lists clob- 
bered precious files. Consequently both utilities were promptly cut back to handle just one from-to 
pair (v2). At the same time mv was generalized to move files to a named directory. Strangely cp 
picked up only a BUG note suggesting the feature. By the time of v3 both had converged to their 
present forms, although an unexplained option -t intruded briefly in v5. What seems natural in 
hindsight was not clear cut at the time: the final conventions arose only after long discussions about 
how properly to handle file permissions and multiple files. In fact the discussion is not yet closed. 
Whether and how to recurse on directories is still debated: v7, v8, and v9 each offered a different 
way to do it. 



• Ken's ken was probably the last to saturate. At the time of v5, shell accounting once revealed that Thompson 
had used 102 distinctly named programs in the course of a week. Nobody else came close, 
t The cat page from vl is reproduced on page 16 of this report. 
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SORT (vl page 19, v5 page 20) 

This mainstay utility began as a "user-supported progam" in chapter 6 of vl (Thompson). 
Upon query to the author it turned out that the "wide options" announced there involved altering 
the source. The first official options appeared in v4. Expanding ever since, the load of options 
reached 17 in v9 (Mcllroy and John P. Linderman of the Computer Technology Research Lab). 
The program originally sorted in core; pressure of real use soon forced it to spill to disk. 

The first design, typical of pre-pipe days, had an argument to name the output (see GREP 
below) : 

sort input output 

During the pipeline revolution Thompson modified sort to be usable as a filter (v4). Unlike most 
utilities, though, sort did retain an output-naming convention because it was so often used to sort a 
file in place, which couldn't be done with >. 

When he extended sort to handle multiple files, Thompson invented a special name "-" for 
the standard input (v5). The convention caught on and soon infected many other commands. As a 
property of particular commands and not of the system as a whole, "-" itched naggingly. The itch 
went unscratched until Ritchie, at Pike's suggestion, installed f d special files synonymous with 
already open file descriptors (v8) . The stubborn disease remains, however. 

A bug note in join{\) declares, "The [field-specification] conventions of join, sort, comm. 
uniq, look and awk(l) are wildly incongruous." Although these programs are often used together, 
they remain, like American weights and measures, sturdily eccentric. 

MAIL (vl page 21, v7 page 22) 

Electronic mail was there from the start. Never satisfied with its exact behavior, everybody 
touched it at one time or another: to assure the safety of simultaneous access, to improve privacy, to 
survive crashes, to exploit uucp, to screen out foreign freeloaders, or whatever. Not until v7 did the 
interface change (Thompson) . Later, as mail became global in its reach, Dave Presotto took charge 
and brought order to communications with a grab-bag of external networks (v8). 

Despite the turbulent evolution of mail, to this day a simple postmark is all that it adds to 
what you write. Old UNIX hands groan at the monstrous headers that come from latter-day mailers 
and at the fatness of their manuals. 

ECHO (v2 page 23) 

Echo, seemingly the simplest of utilities, originated with Multics, where it was used to test the 
sanity of the shell. The present version arose as a finger exercise in C programming (Mcllroy, v2). 
Then it turned out to be useful, a mainstay of shell scripts. 

For a while echo was complemented by prompt (never documented), which did the same thing 
without a newline. Eventually prompt was displaced by echo -n (Ritchie, v7). Meanwhile a 
minor echo-amplification industry arose in some quarters. Imported versions of echo with elaborate 
syntax came and went in a midnight vendetta; for a time it was the least stable of all commands. 
Ritchie calmed the altercation with a Solomonic but un-UNIX-like option to switch between two 
competing syntaxes (v8). Not surprisingly, the more elaborate choice has never been needed in any 
shell script in /bin or /usr/bin . The whole episode inspired Mcllroy's parable, "The Unix and 
the Echo," quoted in [5], page 79. 

GREP (v4 page 24) 

Grep, generally cited as the prototypical software tool, was born when Ken Thompson was 
asked how to search for patterns in a file that was too big for the editor. Thompson promptly 
liberated his regular expression recognizer and christened it after the ed command g/re/p. It was 
an instant hit and soon entered our language as a verb. 

The success of grep suggested other utilities. One of these, gres for global substitution, 
evolved into the stream editor sed (McMahon, v7). Grep also inspired Al Aho to apply his 
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encyclopedic knowledge of language theory to make the very general egrep and the highly special- 
ized fgrep (v7). Over the years Aho honed egrep into an awesomely performing program, simple on 
the outside but the highest of tech on the inside. 

The v4 manual page for grep is typical of earlier editions. Options were described in running 
text along with the basic usage; the more readable convention of always displaying options 
separately, no matter how few a command might have, gained ground only slowly. In typical early 
style the synopsis permits an output argument as well as an input argument— poor human engineer- 
ing, because of the disastrous consequences of invoking command input output as if were com- 
mand input 1 input2. This dangerous syntax was expunged from most commands by v7, but at 
least one fossilized instance survives in BSD 4.3. 

3. Programming 

3.1. The Shell 

SH (vl pages 25-27, v3 pages 28-33, v4 pages 34-36) 

The name and the general outline of the "shell" originated in Multics, but for UNIX the shell 
had to be pared back to basics to fit in an 8K user space. There wasn't even enough room to do * 
name expansion; that task was handed off to another program glob, signifying "global" (Ritchie, 
vl). {Glob, written in B, was the first piece of mainline UNIX software to be done in a higher level 
language.) 

The shell read commands from the same standard input as did programs that it invoked. Thus 
commands and data were interleaved in command files, or "runcoms,"* now usually called shell 
scripts. There was no way to mark the end of embedded data files; programs that buffered their 
input would consume input not intended for them. Consequently programs that were likely to read 
from shell scripts, especially sh and ed, were made to read their input one character at a time. It 
was impossible to pipe into a shell script because the standard input was already dedicated to the 
script. For the same reason a program in a shell script could not take input from a terminal except 
when given the terminal's real name. None of these problems was addressed until the Bourne shell 
solved them all at once (v7). 

A shell notation for composing programs into pipelines accompanied Mcllroy's proposal for 
pipes. This new idea, with its curious syntax, took almost a page to describe (v3). The syntax was 
reformed when, to avoid the embarrassment of describing it in a big public talk, Thompson proposed 
the appealing infix ! . Thus naturalized, pipelines became describable in just four sentences in v4. 

The UNIX shell gave up the Multics idea of a search path and looked for program names that 
weren't file names in just one place, /bin. Then in v3 /bin overflowed the small (256K), fast 
fixed-head drive. Thus was /usr/bin born, and the idea of a search path reinstated. 

GOTO, : (v2 pages 37-38) 

Goto manipulated the standard input to give the illusion of a programmable shell (Thompson, 
v2). The associated : command, which thanks to ASCII collating sequence boasted the first page in 
the manual, was a big nop. 

Other flow-of-control programs were if, to execute a command conditionally (Ritchie and 
Thompson, v2), and exit (Thompson v2). With the luxury of bigger computers. Bourne made a 
genuinely programmable shell and abolished these clever but clumsy tricks (v7). Nevertheless : sur- 
vives as a built-in shell command and test has inherited the boolean capabilities of //. 



* Runcorn, a program that could run a short script of commands in the background, was the closest thing MIT's 
CTSS had to a callable shell. A vestige of the name survives in the boot script, /etc/rc. 



3.2. System Calls 



STAT (vl page 39, v4 page 40, v7 pages 41-42) 

Stat is one of very few original system calls to have changed at all, mostly because through it 
user code glimpses system tables. In v4 group permissions appeared and file sizes went from 16 to 
24 bits. The size change was tough; it meant rebuilding every existing file system, and the longer 
addresses compelled some trickery to avoid sacrificing space or performance on smaller files. 

The snapshots of stat also show how the style of description evolved from assembly language 
(vl) through C (v4) to a more abstract and portable form with declarations hidden in include files 
(v7). The traditional sense of what constituted the real system interface eroded very slowly. Even 
though almost all programs were written in C, assembly language held pride of place in the manual 
through v6. Banished to a footnote in v7, assembly language did not disappear completely until v8, 
twelve years after the birth of C. 

PIPE (v3 page 43) 

The basic redirectability of input-output made it easy to put pipes in when Doug Mcllroy 
finally persuaded Ken Thompson to do it. In one feverish night Ken wrote and installed the pipe 
system call, added pipes to the shell, and modified several utilities, such as pr and ov (see 5.1 
below), to be usable as filters. The next day saw an unforgettable orgy of one-liners as everybody 
joined in the excitement of plumbing. Pipes ultimately affected our outlook on program design far 
more profoundly than had the original idea of redirectable standard input and output. 

All programs placed diagnostics on the standard output. This had always caused trouble when 
the output was redirected into a file, but became intolerable when the output was sent to an 
unsuspecting process. Nevertheless, unwilling to violate the simplicity of the standard-input- 
standard-output model, people tolerated this state of affairs through v6. Shortly thereafter Dennis 
Ritchie cut the Gordian knot by introducing the standard error file. That was not quite enough. 
With pipelines diagnostics could come from any of several programs running simultaneously. Diag- 
nostics needed to identify themselves. Thus began a never quite finished pacification campaign: a 
few recalcitrant diagnostics still remain anonymous or appear on the standard output. 

The first implementation of pipes used a single file descriptor for both reading and writing 
(v3). The modern scheme, with two file descriptors, came in the next edition. 

INTR (vl page 44), SIGNAL (v4 page 45) 

In vl there was a separate system call to catch each of interrupt, quit, and two kinds of 
machine traps. Floating point hardware (v3) brought another and no end was in sight. To stop the 
proliferation, all traps were subsumed under a single system call, signal (v4). The various traps 
were given numbers, by which they were known until symbolic names were assigned in v7. We have 
not been fully weaned yet: the numbers are still needed in the shell trap command. 

A simple unconditional kill was available to terminate rogue programs in the background 
(v2). In v5 kill was generalized to send arbitrary signals. Never, however, was the basically 
unstructured signal-kill mechanism regarded as a significant means of interprocess communication. 
The research systems therefore declined to adopt the more reliable, but also more complex, Berkeley 
signals. 

In general, research UNIX systems, out of a belief that asynchrony is nasty, have provided less 
overt support for it than have some of their relatives. Thus when multiprocess coordination is una- 
voidable, as for receiving mail, curious synchronizing tricks with dummy files have been resorted to. 
The short-lived multiplexor (Chesson, v7), then Ritchie's /dev/pt named pipes and select 
(adapted from Berkeley) lent, some support for these special needs (v8); Presotto's ipc code goes still 
further (v9). 

The research systems remain standoffish about unbridled parallelism; the recent facilities for 
asynchrony are used only by cognoscenti. Nevertheless users of UNIX systems are probably more at 
home with parallel computing— as structured by pipes— than is almost any other user community. 
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STTY (v2 pages 46-47), IOCTL (v7 page 48) 

Ioctl is a closet full of skeletons. The ioctl story began with stty (v2), the primary use of 
which— setting modes upon logging in— was unexceptionable. Trouble set in when other programs 
began to use it. These programs would work for their owners on their owners' terminals, but could 
fail frustratingly in other settings. Thus was the slippery slope to curses first glimpsed. 

Stty accumulated features gradually, and often incompatibly. Eventually it was rechristened 
ioctl to keep abreast of plans for the corporate standard release 3.0 (v7). This faceless name, with 
no intrinsic meaning, quickly acquired more than enough. It was somehow exempt from the ethos of 
simplicity that kept the lid on new system calls. All kinds of functions were piled onto ioctl. The 
interface varied bewilderingly from function to function and from system to system. Documented 
willy-nilly throughout chapter 4 and sometimes only in source code, its true dimensions can never be 
appreciated. 

3.3. Standard 10 
PRINTF (v4 page 49) 

Output formatting was originally left up to programmers (or to Fortan). Although vl 
included conversion routines like atof, the print/ routine that Ritchie had long since devised for 
BCPL did not arrive until the C change (v4). Formatted input was even slower in coming: Mike 
Lesk's portable IO library that included scanf, as well as gets and ungetc, did not become official 
until v7. 

PUTC (vl page 50), STDIO (v7 page 51) 

Buffered 10 was, and still is, a necessary evil. A rudimentary buffering package with getcQ 
and putcQ in vl required the user to supply buffers and manage file descriptors. This scheme per- 
sisted until Ritchie's stdio reconciled the buffering package with Lesk's portable IO, hid the depen- 
dence on file descriptors, and eliminated per-character function calls. In one clean sweep stdio 
made C programs easily portable. In the ANSI draft standard for C stdio enjoys equal status with 
the language proper. 

3.4. Languages 

Almost everybody in the group has done languages. Thompson and Ritchie built assemblers 
from scratch. On the tiny PDP-7 the assembler was supplemented by tmg, Doug Mcllroy's version 
of Bob McClure's compiler-compiler. Using it Thompson wrote B, the evolutionary link between 
Martin Richards's (Cambridge University) BCPL and C. The PDP-11 assembler, a desk calculator 
dc, and B itself were written in B to bootstrap the system to the PDP-11. Because it could run 
before the disk had arrived, dc— not the assembler— became the first language to run on our PDP- 
1 1 . Soon revised to handle arbitrary-precision numbers (v 1 ) , dc was taken over by Bob Morris and 
Lorinda Cherry. It now ranks as the senior language on UNIX systems. 

CC (v2 page 52) 

As a testbed for floating-point routines in vl Thompson wrote bas, a Basic-like interpreter. It 
survived as long as we used PDP-lls. V2 saw a burst of languages: a new tmg, a B that worked in 
both core-resident and software-paged versions, the completion of Fortran IV (Thompson and 
Ritchie), and Ritchie's first C, conceived as B with data types. In that furiously productive year 
Thompson and Ritchie together wrote and debugged about 100,000 lines ol production code. 

Conversion to C made UNIX, already elegant and capable, into a system also intelligible, pli- 
able, and ultimately portable. It elicited a flood of utilities and made it easier to refine the kernel. 
As the compiler evolved, the system benefited too: better object code meant speedups and space sav- 
ings across the board. More than once an overgrown kernel was squeezed back into place by attend- 
ing to the compiler. 
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Portable utilities written in C spread easily to other computing environments at Bell Labs. 
Gradually users became able to deal with systems from several manufacturers on the same terms: 
programs like Is, cp, and above all sh worked similarly everywhere. With the human, if not the 
machine interfaces already established, the ultimate transition to UX systems proper on mainframes 
was remarkably gentle. 

YACC (v3 page 53) 

With yacc Steve Johnson reduced to practice Al Aho's expertise in language theory (v3). 
Yacc, abetted by Mike Lcsk's lex (v7), stimulated a language industry. Among the better known 
vacc-based processors are 

eqn for typesetting equations (Kernighan and Cherry, v5) 

ratfor, which provided C-like syntax for Fortran (Kernighan, v6) 

be for arbitrary-precision computation (Morris and Cherry, v6) 

m4, a general macroprocessor (Kernighan, v7) 

apl, Iverson's language (Thompson, v7) 

struct, convert Fortran to Ratfor (Brenda S. Baker, v7) 

J77, a Fortran 77 compiler (Feldman and Weinberger, v7) 

awk, a pattern-directed file-processing language (Aho, Weinberger and Kernighan, v7) 

pec, a portable C compiler (Johnson, v7) 

pic for typesetting line drawings (Kernighan, v8) 

ideal, a constraint-based language for typesetting line drawings (Chris (Christopher J.) Van 
Wyk, v8), 

C++, an "object-oriented" extension of C (Bjarne Stroustrup, v8) 

hoc, a C-like "desk-calculator" language (Kernighan and Pike, v8) 

grap for typesetting graphs (Kernighan and Jon L. Bent ley, v9) 

Several of these languages are tours de force: eqn for its insightful syntax, be -de for its unique 
variable-precision math library, struct for finding both structure and theorems in undisciplined code, 
ideal for enlisting symbolic computation in the service of drafting. Yacc, by eliminating much 
drudgery of compiler-writing, made possible the extensive experimentation that underlies these novel 
languages. It is no exaggeration to say that without yacc some would never have been undertaken, 
and many would not have evolved into more than mere demonstrations. 

4. Applications 

4.1. Text Processing 

Among the early justifications for the research activity that produced the UNIX system was 
the potential for text-processing. Thus the first significant application program was roff, which 
printed the manuals for vl, v2, and v3 (Thompson and Ritchie) and attracted the first outside 
client, the patent department at Bell Labs. 

Thereafter Joe Ossanna became the driving force behind UNIX text formatting software. His 
macro-based, trap-driven nroff appeared in v2. When Graphics Systems, Inc., announced an inex- 
pensive typesetter with ASCII paper tape input, Ossanna sprang for one, replaced the tape reader 
with a wire to the computer, and modified nroff for multiple fonts and proportional spacing. Voila, 
troff It blew the manufacturer's mind, and touched off a flurry of homemade documents in flam- 
boyant layouts— good enough, however, to fool referees into suspecting that the manuscripts had 
been published before. 

Ossanna's ultimate intent, that macros should foster higher-level typsetting languages, was 
finally realized with the invention of the -ms macros (Lesk, v7, but dating from 1976). 
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FORM (vl page 54), TYPO (v3 page 55) 

"Text processing" means considerably more than mere text formatting. The elegant form 
letter generator was written by Thompson from Morris's original on CTSS (vl). Augmented by a 
special editor fed (Cherry, v2) form provided a genuine personal database. McMahon, Morris, and 
Cherry together collected a substantial corpus of text and studied it statistically [81. Some of their 
tools, particularly uniq (Thompson, v3) and comm (McMahon, v4) became staples. Out of that 
work came the remarkable typo, which spotted typing errors by statistical inference (Morris and 
Cherry, v3). Eventually Steve Johnson's spell, a virtuoso demonstration of tools in use (see page 
126 of [6]), shouldered typo aside (v5) and spurred Mcllroy to engineer a sophisticated version 
(v7). 

Form was really a macroprocessor with persistent memory. The long tradition of macros at 
Bell Labs assured that others would appear: m6 by Mcllroy, Morris and Andrew D. Hall, then m4 
(Kernighan and Ritchie) . And macros of course were central to the text formatters, roff, nroff, and 
troff. 

OV (v3 page 56) 

Ov did multicolumn formatting cheaply and elegantly (Ossanna, v3). One printed a narrow 
column with every other page offset one-half a page width and then ran the output through ov, 
which or-ed pairs of pages together. The following 4-column wonder was shown off on the first day 
of pipes: 

roff file >ov>ov> 

which means in modern language, roff file ' ov ! ov. Ov was ultimately killed off by pr 
-n and features built into nroff (v5). 

WWB (v8 page 57) 

Cherry's work on approximate parsing and Aho's on fast pattern search turned out to be just 
the right foundation for an English style-appraiser suggested by Prof. William Vesterman of 
Rutgers. That in turn was elaborated into Writer's Workbench by Nina (Antonina H.) Mac- 
Donald and others in the Human Performance Engineering Department (v8). WWB attracted 
unusual attention from the popular press, including the New York Times and the Today show. 

4.2. Navigation 

SKY (v4 page 58) 

By some quirk of providence, many members of the group have been fascinated by navigation, 
geodesy, and astronomy. The first celestial program was Ossanna's satellite predictor, azel, which 
had guided the ground station for Telstar (v2). Morris's, then Thompson's sky programs predicted 
everything else, giving daily voice and mail announcements like, "Eclipse of the moon at 8:42 PM." 
Mcllroy's map, intended to display the earth on dozens of projections (v7), was used by McMahon 
to portray the heavens. Upon databases of maps, stars, cities, airports, and weather were built route 
planners for car (blitmap, Lesk and Elliott, v8) and plane (Thompson) and an astronomer's infor- 
mant (scat, Pike, v9). 

WWV (v8 page 59) 

Already in vl were routines, cal (Thompson) and dime (Ritchie), that knew calendrical facts 
well beyond any immediate system need. In the 1980s, as the lab's work spread across a network of 
machines, the many aberrent clocks became intolerable. Andy Koenig made the most of a cheap 
and jittery receiver for the National Bureau of Standards broadcast time standard wwv, arranging 
for individual clocks to adjust to the standard smoothly, without backdating. Later Condon installed 
and Thompson programmed a robust filter for a raw time receiver on an almost uninterruptable 
computer called "the rock" (v9). 
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4.3. Design Automation 
CDL (v7 pages 60-63) 

Although most users do not encounter the UNIX Circuit Design System, it has long stood as 
an important application in the lab. Originated by Sandy Fraser and extended by Steve Bourne, Joe 
Condon, and Andrew Hume, UCDS handles circuits expressed in a common design language, cdl. It 
includes programs to create descriptions using interactive graphics, to lay out boards automatically, 
to check circuits for consistency, to guide wire-wrap machines, to specify combinational circuits and 
optimize them for programmed logic arrays (Chesson and Thompson). Without UCDS, significant 
inventions like Datakit, the 5620 Blit terminal, or the Belle chess machine would never have been 
built. UCDS appeared in only one manual, v7. 

5. Communication 
TSS (v2 page 64) 

The members of the research group had no desire to isolate themselves from the rest of the 
Bell Labs computing community. Nor could they at first justify the purchase of equipment such as 
line printers and tape drives, which cost more than their whole computer. Thus, besides dial-up 
access, which was a sine qua non, communication with other machines was a necessity. A 2000bps 
link provided remote job entry to the GECOS system at the Bell Labs computer center (opr, 
Thompson, v2). GECOS guru Charlie Roberts contributed tss to exploit the link for remote login 
and interactive file transfer (v2). Similar programs to communicate with IBM mainframes fol- 
lowed. 

Unlike most of the basic facilities of the system, which distilled years of well-established prac- 
tice, computer-to-computer communication has been a subject of almost continuous experimentation. 
The need to connect to foreign systems exacerbates the problem of making a coherent model for 
communication. Ken Thompson more than once returned to ground zero, building experimental 
communication-based systems from scratch. 

NFS (v7 pages 65-66), DCON (v8 page 67) 

Sandy Fraser, aided by Jane Elliott, made our first local-area net, Spider, and its far-more- 
than-local-arca successor based on the Datakit switch. Spider provided nfs, a remote network file 
store for a dozen minis (v7). Greg Chesson wrote remote-connection programs for direct machine- 
to-machine links. These programs, ultimately to become icon (Chesson) and rx (Pike) for remote 
login and execution, were adapted to Datakit as soon as it became available. More recently they, 
and connection programs for other networks, have been reworked to exploit a general server 
mechanism by Ritchie and Presotto (v8). 

Datakit connections sparked a version of the standard IO library that gave access to remote as 
well as local files (Fraser and Priscilla Lu). Ritchie's work on IO streams eventually made possible 
Weinberger's network file system, /n, which provided remote access through the kernel. Not to be 
confused with the central file server for Spider, Weinberger's file system is simply the union of all 
the files across all communicating machines. There is no manual page about how to use it because 
there is nothing to say. Remote file systems are "mounted" locally so that remote accesses look just 
like local accesses. 

6. Security 

SU (vl page 68, v8 page 69) 

Whether the system was actually run securely or not, considerable care has always been taken 
to assure that it is possible to do so. Permissions and Ritchie's patented set-userid mechanism were 
already supported in vl. From Cambridge, England, came the idea of password encryption that 
went into v3. 

Trojan Horse tricks and countermeasures were discovered in an ongoing game that has been 
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recounted by Morris and Fred Grampp [4]. Notice, for example, the removal of login(l) to chapter 
8 and the intrusion of /etc/ into the synopsis for su (Grampp, v8). These fillips defeated the old 
chestnut of leaving programs named login or su lying around in hopes of capturing a password 
typed by an unwary system administrator. Other subtle features of the modern su: dot is excluded 
from the shell search path and the burglars' favorite shell variable IFS is reset. 

CRYPT (v3 page 70, v9 page 71) 

Morris's first file encrypter appeared in v3 with the explicit intent to stimulate code breaking 
experiments. Stimulate it did. Morris himself broke crypt by hand. Later Ritchie automated the 
cryptanalysis using a method of Jim Reeds (Berkeley). Completed with an editor interface, a new 
crypt went public in v7. It also succumbed to an attack by Reeds and Weinberger— and fortunately, 
too: more than one person who locked data in crypt and threw away the key has been rescued by 
code breakers. 

But the still arduous process of code-breaking is not the easiest way to attack crypt. A simpler 
gambit is to catch a system administrator off guard and install a Trojan horse in crypt itself to 
snatch every new secret as it passes by. Thus the very presence of crypt may have just the opposite 
effect on security from what was intended. 

Even if crypt were perfectly safe, it would be unwise to encrypt files of lasting value. It is too 
easy to lose the key, either inadvertently or deliberately. Consequently crypt has been demoted to 
the games chapter (Grampp, v9). 

7. Curiosities 

NUMBER (v6 page 72) 

This filter that converts numbers to check-writing form was whipped up by Thompson (v6) to 
preprocess input to speak, which converted English to phonemes for a Votrax speech synthesizer 
(Mcllroy, v3).* Number was the glue with which Thompson fashioned a talking desk calculator: 

dc ! number ! speak 

The talking calculator could also be reached from an audio shell, through which, with some effort, 
the whole system could be run from a Touch-Tone phone. 

DSW (vl page 73) 

The nostalgically named dsw was a desperation tool designed to clean up files with unutterable 
names. This had been done on the PDP-7 by a program with console switch input; hence the sobri- 
quet "delete from switches." It survived from vl until it was displaced by rm -i (Ritchie, v7). 

DD (v5 page 74) 

Originally intended for converting files between the ASCII, little-endian, byte-stream world of 
DEC computers and the EBCDIC, big-endian, blocked world of IBM, dd was endowed with an 
appropriately bastard syntax (Thompson, v5). Pike has noted a cultural quirk. Much as families 
perpetuate the quaint sayings of children, users are wont to invoke dd with the JCL-ish formula, dd 
if = input of ^output, or perhaps with cat input ! dd of ^output, but rarely with the ele- 
mentary utterance dd < input > output. 



• The UNIX lab was then the only place in the world where one could hear arbitrary text uttered by a machine on 
the spur of the moment. Visitors did a double-take upon being greeted by name. One hapless lounger listening to 
the fun from outside the lab door fled at a sudden sentence, "Stop messing around and get some work done." 
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FACED (v9 page 75) 

Among the novelties inspired by bitmapped terminals was Pike's and Presottos's face server, 
which provides pictures of all users. The face server, like Weinberger's network file system and 
Killian's /proc directory of running core images, is a process that functions as a file system: it 
interprets file names upon open— in this case as connections to a remote repository— and delivers 
data upon read. 

By far the most popular application of the face server is Luca Cardelli's vismon, which 
announces incoming messages with pictures of their senders. 

Enigmatic images resembling that on the FACED page have frequently and inexplicably 
appeared on organization charts, posters, magazine covers, construction fences, and even a water 
tower. 

8. Front matter 

Titles and introductions (pages 76-96) 

This chronological set of front matter comprises all title pages and prefaces plus samples of 
introductions and tables of contents. 

In a bow to user-friendliness, Ritchie added "How to Get started" to the introduction for v3. 
At the typographic watershed where the manual was converted from raff to troff there appeared the 
thinnest, least forbidding UNIX Programmer's Manual of all time, v4 (pages 88-89). For v6 and v7 
Lorinda Cherry prepared a pocket reference, familiarly known as the "Purple Card," which is not 
shown. Thompson gathered a set of Documents for Use with UNIX, also not shown, to accompany 
v6. Kernighan expanded the collection for the v7 manual, but nobody has had the ambition to 
modernize "Volume 2" since. Doug Mcllroy compiled a glossary for the trade book form of v7 [2] 
and all later editions (page 94). Cherry prepared the topical table of contents for v9 (page 96). 

Page 97 touches on software by Pike et al. for the Teletype 5620, the terminal of choice for v8 
and v9. With a megabyte of memory and downloadable programs, the 5620 is a computer system in 
its own right. This fact is reflected in the organization of chapter 9 into subchapters parallel to the 
usual chapters: commands, system calls, subroutines, data layouts, games, etc. The 5620 software 
outweighs that of the original vl in bulk, and offers a similar number of "primitive" functions. 
These facilities radically change the feel, but not the principles, of the UNIX system. Significant as 
it is, the 5620 software has been deliberately slighted in these readings about the common descent of 
UNIX, because the work is still tied to one kind of hardware and because it strikes off in new direc- 
tions that more properly belong to a sequel. 

Tables of contents (pages 98-114) 
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NAME 

SYNOPSIS 
DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



CAT ( I 

cat — concatenate and print 
cat f ... 

g^t reads each file in sequence and writes it on 
the standard output stream. Thus: 

cat file 

is about the easiest way to print a file. Also: 

cat f ilel file2 >f ile3 

is about the easiest way to concatenate files. 

If no input file is given cat reads from the 
standard input file. 

pr f cp 

none; if a file cannot be found it is ignored. 
Ken, dmr 



\ 
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CP 



NAME 

SYNOPSIS 
DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



cp — copy 

ce fil« 11 file 12 fll« 21 f il«22 

Files are taken in pairs; the first is opened for 
reading, the second created mode 17. Then the 
first is copied into the second. 



cat, pr 

Error returns are checked at every system call, 
and appropriate diagnostics are produced. 

The second file should be created in the mode of 
the first. 

A directory convention as used in mv should ba 
adopted to cp . 



OWNER 



Jcen, drar 



\ 
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NAME 

cp - copy 

SYNOPSIS 

cp ( -t ] filel flle2 
DESCUPTTON 

The first file is copied onto the second The mode and owner of the target file are oreserved if it 
already existed; the mode of the source file is used otherwise. preserved (f it 

If file2 is a directory, then the target file is a file in that directory with the file-name of filel. 
No one is quite sure what the flag — t does. 
SEE ALSO 

cat (I), pr OX mv 0) 

BUGS 

Copying a file onto itsdf destroys its contents. 
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NAME sort — sort a file 

SYNOPSIS sort input output 



DESCRIPTION 

FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sor_t will sort the input file and write the sort 
ed file on the output file. Wide options are 
available on collating sequence and ignored char 
acters. 



OWNER 



dmr, ken 



SORT(I) 
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SORTCI ) 



NAME 

sort - son or merge files 

SYNOPSIS 

sort ( -abdnrt* I [ +pas [ —pas 1 J . . . [ -mo J [ name 1 . . 

DESCRIPTION 

Thus may be used as a filter. no inpul file names "e S'ven. 

tetter, Non-ASCH b y « are^cr* TtaSErl£?, ^Ar&JST?" 
of which may appear w oy tne na *s — aoonrt, one or more 

a Do not map lower case letters. 

b Leading blanks (spaces and tabs) are not included in fields. 

d 'Dictionary' order: only letters, digits and blanks are significant in ASCII comparisons 

n ^^^s; ass ar- 1 *■ sign - and °« 

r Reverse the sense of comparisons, 
t* Tab character between fields is x 

.*J«a rasas 

been specified, a field is a string ending with a tab character cnaracier nas 

awasfJwsaBsar a " earl,er ona compafe « uaL 

These flag arguments are also understood: 

-m Merge only, the input files are already sorted. 

~° M?ml?£$^l!? thC nan J C .? f an 0utput fl,e t0 11848 in *«* of standard output. Th.s 
file may be the same as one of the .nputs, except under the merge Hag -m. 

FILLS 

/usr/tmp/sun??? 
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NAME 

SYNOPSIS 
DESCRIPTION 



mail — send mail to another user 



FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 




[ letter person 



] 



mail without an argument searches for a file 
called mailbox , prints it if present, and asks if 
it should be saved. If the answer is "y", the 
mail is renamed mail . otherwise it is deleted. 
The answer to the above question may be supplied 
in the letter argument. 



When followed by the names of a letter and one or 
more people, the letter is appended to each 
person's mailbox . Each letter is preceded by the 
sender's name and a postmark* 

A person is either the name of an entry in the 
directory /usr . in which case the mail is sent to 



/ usr/per son / mailbox , or the path name of a direc- 
tory, in which case mailbox in that directory is 
used. 

When a user logs in he is informed of the pres- 
ence of mail. 

/etc/uids to map the sender's numerical user ID 
to name; mail and mailbox in various directories. 

init 

"who are you?" if the user^cannot be identif ec^ 
for some reason (a bug), "cannot send to user" 
if mailbox cannot be opened. 



ken 
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NAME 

mail — send or receive mail among users 

SYNOPSIS 

mail person ... 

mail ( -r ] ( -q J [ -p J [ -f file ] 
DESCRIPTION 

V/j//with no argument prints a user"s mail, message- by- message, in last-in. first-out order; the 
optional argument -r causes first-in, first-out order. If the -p nag is given, the mail is printed 
with no questions asked; otherwise, for each message, mail reads a line from the standard input 
to direct disposition of the message. 

newline 

Go on to next message, 
d Delete message and go on to the next, 
p Print message again. 
— Go back to previous message. 

s IM ] ... 

Save the message in the named files Ombox' default). 

w [ file 1 ... 

Save the message, without a header, in the named files ('mbox' default), 
m [ person } ... 

Mail the message to the named persons (yourself is default). 
EOT (control- D) 

Put unexamined mail back in the mailbox and stop. 

q Same as EOT. 

x Exit, without changing the mailbox file. 

'command 

Escape to the Shell to do command. 

n Print a command summary. 

An interrupt stops the printing of the current letter. The optional argument -q causes mad to 
exit after interrupts without changing the mailbox. 

When persons are named, mail takes the standard input up to an end-of-file (or a line with just 
V) and adds it to each person s 'mail' file. The message is preceded by the sender's name and a 
postmark. Lines that look like postmarks are prepended with A person is usually a user 
name recognized by logm(\). To denote a recipient on a remote system, prefix person by the 
system name and exclamation mark (see uucp(\)). 

The — f option causes the named file. e.g. 'mbox', to be printed as if it were the mail file. 

Each user owns his own mailbox, which is by default generally readable but not writable. The 
command does not delete an empty mailbox nor change its mode, so a user may make it 
unreadable if desired. 

When a user logs in he is informed of the presence of mail. 

FILES 

/usr/spool/mail/' mailboxes 

/etc/passwd to identify sender and locate persons 

mbox saved mail 

/tmp/ma* temp file 
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NAME 

SYNOPSIS 
DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWN** 



echo — echo arguments 
echo [ arg 1 ... ] 

echo writes all its arguments in order as a line 
on the standard output file. It is mainly useful 
for producing diagnostics in command files. 
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NAME 

grep - search a file for a pattern 

SYNOPSIS 

grep ( -v J [ -| ] ( — n ] expression [input] (output) 

DESCRIPTION 



nag is* 3,1 ,ines but those ™^ SWiSfflf the outp H ut de [ a v. ,l) - ,f ihe - v 

preceded by its line number. If the -n flS nn ** 13 * ch line P rin «d is 

that would normally have been prinw Ms ^teW^ 1 ^*"* 
searched is printed. reported. If interrupt is hit, the number of lines 

For a complete description of the regular exDression «m ~tfn 

•he characters $ • [ * | ( ) and \ in the rSiS ?M?r«i«!f. i Sh ° U ' d 6,5 taken when usin « 
(Precede them by \) ' fe8U,ar ex P ress,on « they are also meaningful to the shell 



SEE ALSO 

ed(I), sh(I) 

BUGS 

Lines are limited to 512 characters; longer lines are truncated. 
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NAME 

SYNOPSIS 
DESCRIPTION 



sh — shell ( command interpreter) 

sh [ name [ arg 1 ... [ arg 9 ] ] ] 

sh is the standard command interpreter. It is 
the program which reads and arranges the execu- 
tion of the command lines typed by most users. 
It may itself be called as a command to interpret 
files of command lines. Before discussing the 
arguments to the shell used as a command, the 
structure of command lines themselves will be 
given. 

Command lines are sequences of commands separated 
by command delimiters. Each command is a se- 
quence of non-blank command arguments separated 
by blanks. The first argument specifies the name 
of a command to be executed. Dccept for certain 
types of special arguments discussed below, the 
arguments other than the command name are simply 
passed to the invoiced command. 

If the first argument represents the path name of 
an executable^ ile, it is invoked; otherwise the 
string "/bin/" is prepended to the argument. (In 
this way the standard commands, which reside in 
"/bin", are found.) If this search too fails a 
diagnostic is printed. 

The remaining non-special arguments are simply 
passed to the command without further interpreta- 
tion by the shell. 

There are three^command delimiters; m the new 
line, " , and The semicolon ; specifies 

sequential execution of the commands so 
separated; that is, 

coma; comb 

causes the execution first^of command coma , then 
of comb . The ampersand "i causes simultaneous 
execution: 

coma & comb 

causes coma to be called, followed immediately by 
comb without waiting for coma to finish. Thus 
coma and comb execute simultaneously. As a spe- 
cial case, 

coma & 

causes coma to be executed and the shell immedi- 
ately to request another command without waiting 
for coma. 
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Two characters cause the immediately following 
string to be interpreted as a special argument to 
the shell itself, not^passed to the command. An 
argument of the form "<arg causes the file arg 
to be used as the standard input file of the 
given command; an argument of the form ">arg" 
causes file "arg" to be used as the standard out- 
put file for the given command. 

If^any argument contains either of the characters 

or "* , it is treated specially as follows. 
The current directory is searched for files^which 
match the given argument. The character in 
an argument matches any string of characters in a 
file name (including the null string); 
matches any single character in a file name. 
Other argument characters match only the same 
character in the file naroe ; For example, 
matches all file names; "jl matches all one-char- 
acter file names; ^ab*.s" matches all fjle names 
beginning with ab and ending with ".s . 

Jf^the argument with "** or "? * also contains a 

/ , a slightly different procedure is used: 
instead of the current directory, the directory 
used is the one^obtained by taking the argument 
up to the last /" before a *•** or "?". The 
matching process matches the remainder of the 
argument after this /" against the files in the 
derived directory. For example: "/usr/dmr/a* . s" 
matches all^files in directory ^/usr/dmr" which 
begin with "a" and end with ".s". 

In any event, a list of names is obtained which 
match the argument. This list is sorted into 
alphabetical order, and the resulting sequence of 
arguments replaces the single argument containing 
the or "? " . The same^process is carried out 
for each argument with a * or ? (the result- 
ing lists are not merged) and finally the command 
is called with the resulting list of arguments.. 

Ffcr example: directory /usr/dmr contains the 
files al.s, a2.s, a9.s. From any directory, 

the command 

as /usr/dmr/a? . s 

calls a^s. with arguments /usr/dmr/al . s , 
/usr/dmr/a2 .s , ... /usr/dmr/a9. s in that order. 

The character "\" causes the immediately follow- 
ing character to lose any special meaning it may 
have to the shell; in this way "<", > , and 
other characters meaningful to the shell may be 
passed as part of arguments. A special case of 
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this feature allows the continuation of commands 
onto more than one line: a new-line preceded by 
"\" is translated into a blank. 

Sequences of characters enclosed in double (") or 
single (') quot.es are also taken literally. 

When the shell is invoked as a command, it has 
additional string processing capabilities. Re- 
call that the form in which the whell is invoked 
is 

sh [ name [ arg 1 ... [ arg g ] ] ] 

The name is the name of a file which will be read 
and interpreted. If not given, this subinstance 
of the shell will continue to read the standard 
input file. 

In the file, character sequences of the form 

"sn", where n.is a digit 0, 9, are replaced 

by the nth argument to the invocation of the 

shell (arg ). "$0" is replaced by name . 

n — — 

An end-of-file in the shell's input causes it to 
exit. A side effect of this fact means that the 
way to log out from UNIX is to type an end of 
file. 

FILES /etc/glob 

SEE ALSO [reference] , which gives the theory of operation 

of the shell. 

DIAGNOSTICS "? " , in case of any difficulty. The most common 

problem is inability to^find the given command. 
Others: input file ("<") cannot be found; no 
more processes can be created (this will allevi- 
ate itself with the passage of time). Note that 
no diagnostic is given for inability to create an 
output (*>") file; the standard output file has 
already been closed when the condition is 
discovered and there is no place to write the 
diagnostic. 

If a or "? " is^used, the glob routine is 
invoked; it types **No command if it cannot find 
the given command, and "no match" if there^were 
no files which matched an argument with ? or 
• 

BUGS Better diagnostics should be provided. If a 

•or is used, the command must be in /bin . 

(Not, for example, in the user's directory.) This 
is actually a glob bug. 
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NAME sh — shell (command interpreter) 

SYNOPSIS sh [ name [ a^ ... [ arg g ] ] ] 

DESCRIPTION 

sh is the standard command interpreter. It is the pro- 
gram which reads and arranges the execution of the com- 
mand lines typed by most users. It may itself be called 
as a command to interpret files of commands. Before dis- 
cussing the arguments to the shell used as a command, the 
structure of command lines themselves will be given. 

Command lines 

Command lines are sequences of commands separated by com- 
mand delimiters. Each command is a sequence of non-blank 
command arguments separated by blanks* The first argu- 
ment specifies the name of a command to be executed. 
Except for certain types of special arguments discussed 
below, the arguments other than the command name are 
passed without interpretation to the invoked command. 

If the first argument is the name of an executable file, 
it is invoked; otherwise the string "/bin/" is prepended 
to the argument. m (In^this way most standard commands, 
which reside in /bin ftf are found.) If no such command is 
found, the string w /usr is further prepended (to give 
/usr/ bin/ command" ) and another attempt is made to exe- 
cute the^resulting file. (Certain "overflow" commands 
live in /usr/bin .) If the "/usr /bin" file exists, but 
is not executable, it is used by the shell as a command 
file. That is to say it is executed as though it were 
typed from the console. If all attemots fail, a diagnos- 
tic is printed. 

The remaining non-special arguments are simply passed to 
the command without further interpretation by the shell. 

Command delimiters 

Thmrm are three command delimiters: the new-line, ";", 
and & . The semicolon • specifies sequential execu- 
tion of the commands so separated; that is, 

coma; comb 

causes the execution first of command coma , then of comb . 
The ampersand "&" causes simultaneous execution: 

coma & comb 

causes coma to be called, followed immediately by comb 
without waiting for coma to finish. Thus coma and comb 
execute simultaneously. As a special case, 
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causes coma to be executed and the shell immediately to 
request another command without waiting for coma . 

Termination Reporting 

If a command (not followed by "&") terminates abnormally, 
a message is printed. (All terminations other than exit 
and interrupt are considered abnormal.) The following is 
a list of the abnormal termination messages: 

Bus error 

Trace/BPT trap 

Illegal instruction 

IOT trap 

Power fail trap 

EMT trap 

Bad system call 

Quit 

PIR trap 

Floating exception 

Memory violation 

Killed 

User I/O 

Error 

If a core image is produced, " — core dumped" is append- 
ed to the appropriate message. 

Redirection of £/0 

Three character sequences cause the immediately following 
string to be interpreted as a special argument to the 
shell itself, not passed to the command. 

An argument of the form "<arg" causes the file arc to be 
used as the standard input file of the given command. 

An argument of the form ">arg" causes file "erg" to be 
used^aa the standard output file for the given command. 

Arg is created if it did not exist, and in any case is 
truncated at the outset. 

An argument of the form ">>arg" causes file "arg" to be 
used^as the standard output for the given command, if 

arg did not exist, it is created; if it did exist, the 
command output is appended to the file. 

Pipes and Filters 

A pipe is a channel such that information can be written 
into one end of the pipe by one program, and read at the 
other end by another program, (see pipe (II)). A filter 
is a program which reads the standard input file, per- 
forms some transformation, and writes the result on the 
standard output file. By extending the syntax used for 
redirection of I/O, a command line can specify that the 
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output produced by a command be passed via a pipe through 
another command which acts as a filter. For examole: 

command >filter> 

More generally, special arguments of the form 

>f 1 >f 2 >...> 

specify that output is to be passed successively through 
the filters f . f j» and end up on the standard out- 

put stream. By saying instead 

>f 1 >f 2 >...>file 

the output finallv ends up in file . (The last could 
also have been a »" to specify concatenation onto the 
end of file .) 

In exactly analogous manner input filtering can be speci- 
fied via one of 

<f-<f 2 <...< 

<f 1< C 2 < - -,<fil# 

Both input and output filtering can be specified in the 
same command, though not in the same special argument. 

For example: 

Is >pr> 

produces a listing of the current directory with page 
headings, while 

Is >pr>xx 

puts the paginated listing into the file xx. 

If any of the filters needs arguments, quotes can be used 
to prevent the required blanK characters from violating 
the blanXless syntax of filters. For examples 

Is >"pr -h 'My directory'"> 

usee quotes twice, once to protect the entire p_r command, 
once to protect the heading argument of pr . (Quotes are 
discussed fully below.) 

Generation of argument lisf 

If any argument contains any of the characters "?*, 
or '[ , it. Is treated specially as follows. The current 
directory Is searched for files which match the given 
argument. 
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The character * in an argument matches any string of 
characters in a file name (including the null string). 

The character matches any single character in a file 
name . 

Square brackets "[...]" specify a class of characters 
which matches any single file-name character in the 
class. Within the brackets, each ordinary character is 
taken to be a^member of the class. A pair of characters 
separated by places in the class each character lexi- 
cally greater than or equal to the first and less than or 
equal to the second member of the pair. 

Other characters match only the same character in the 
file name. 

For example, matches all file names; matches all 

one-character file names,; "[ab], # ,i" matches all Jile 
names beginning with a or b and ending with ,s ; 
^[zi-mj matches all two-character file names ending 
with "2 or the letters "i" through "m". 

If the argument with or also contains a "/", a 
slightly different procedure is usedt instead of the 
current directory, the directory used is^the one obtained 
by^taking the argument up to the last V before a or 
"?"• The matching process matches the remainder of the 
argument after this / against the files in the derived 
directory. For example; /usr/dmr/a # .s" matches all 
files in directory "/uir/dmr" which begin with "a" and 
end with .s . 

In any event, a list of names is obtained which match the 
argument* This list is sorted into alphabetical order, 
and the resulting sequence of arguments replaces the sin- 
gle argument containing the "[", or ?" • The same 
process is carried out for each argument (the resulting 
lists are not merged) and finally the command is called 
with the resulting list of arguments. 

For examples directory /usr/dmr contains the files ai.s, 
a2.a, •••» a9.s. From any directory, the command 

\ as /usr/dmr/a?.s 

calls aj with arguments /usr/dmr/al .s , /usr/dmr/a2.s , ... 
/usr/dmr/a9.s in that order. 

Quoting 

The character m \ m causes the immediately following char- 
acter to lose any special^meaning it may have to the 
shell; in this way "< , ">", and other characters mean- 
ingful to the shell may be passed as part of arguments. 
A special case of this feature allows the continuation of 
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commands onto more than one line: a new-line preceded by 
\ ia translated into a blank. 

Sequences of characters enclosed in double ( H ) or single 
( ) quotes are also taken literally. 

Argument passing 

When the shell is invoked as a command, it has additional 
string processing capabilities. Recall that the form in 
which the shell is invoked is 

sh [ name [ arg 1 ... [ arg g ] ] ] 

The name is the name of a file which will be read and 
interpreted. If not given, this subinstance of the shell 
will continue to read the standard input file. 

In command lines in the file (nofc in command input), 
character sequence! of the form $n , where n is a digit 
0, 9, are replaced by the nth argument to the invo- 

cation of the shell (arg R ), $o" is replaced by name . 

End of file 

An end-of-file in the shell's input causes it to exit. A 
side effect of this fact means that the way to log out 
from UNIX is to type an end of file. 

Special commands 

Two commands are treated specially by the shell. 

"chdir" is done without spawning a new process by execut- 
ing the svs chdir primitive, 

"Login" is done by executing /bin/login without creating 
a new process. 

These peculiarities are inexorably imposed upon the shell 
by the basic structure of the UNIX process control sys- 
tem. It is a rewarding exercise to work out why. 

Command file errors : interrupts 

Any shell-detected error, or an interrupt signal, during 
the execution of a command file causes the shell to cease 
execution of that file. 



Input not found , when a command file is specified which 
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cannot be read; 

"Arg count", if the number of arguments to the chdir 
pseudo -command is not exactly 1 , or if "♦" "?" or "[" 
is used inappropriately; 9 

"Bad directory", if the directory given in "chdir" cannot 
be switched to; 

Try again , if no new process can be created to execute 
the specif ied^command ; 

imbalance , if single or double quotes are not 
matched; 

^Input file"^ if an argument after cannot be read; 

Outout file , if an argument after >" or "»" cannot be 
written (or created); 

Command not found", if the soecified command cannot be 
executed #w 

No match", if no arguments are generated for a command 
which contains • , ? , or "C". 
Termination messages described above. 

BUGS If any argument contains a quoted "?", or "[", then 

all instances of these characters must be quoted. This 
is^becauee- sh^calla the glob routine whenever an unquoted 
• , ? , or [ is noticed; the fact that other in- 
stances o£ these characters occurred quoted is not no- 
ticed by glob , 

when outout is redirected, particularly through a filter, 
diagnostics tend to be sent down the pipe and are some- 
times lost altogether. 
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NAME 

sh — shell (command interpreter) 

SYNOPSIS 

sh [ name ( argi ... [ arg9 1 1 1 

DESCRIPTION 

Sh is the standard command interpreter. It is the program which reads and arranges the execu- 
t.on of the command lines typed by most users. It may itself be called as a command to inter- 
pret hies of commands. Before discussing the arguments to the Shell used as a command the 
structure of command lines themselves will be given. 

Commands. Each command is a sequence of non-blank command arguments separated by 
blanks. The first argument specifies the name of a command to be executed. Except for certain 
types of special arguments discussed below, the arguments other than the command name are 
passed without interpretation to the invoked command. 

If the first argument is the name of an executable file, it is invoked; otherwise the string '/bin/* is 
prepended to the argument. (In this way most standard commands, which reside in '/bin 1 are 
found.) If no such command is found, the string 7usr' is further prepended (to give 
/usr/bin/command) and another attempt is made to execute the resulting file. (Certain lesser- 
used [commands live in 7usr/bin\) If the Vusr/bin' file exists, but is not executable, it is used by 
the Shell as a command file. That is to say it is executed as though it were typed from the con- 
sole. If all attempts fail, a diagnostic is printed. 

Command lines. One or more commands separated by 1' or constitute a pipeline. The stan- 
dard output of each command but the last in a pipeline is taken as the standard input of the next 
command. Each command is run as a separate process, connected by pipes (see pipedl)) to its 
neighbors. A command line contained in parentheses '( )' may appear in place of a simple com- 
mand as an element of a pipeline. 

A command line consists of one or more pipelines separated, and perhaps terminated by or «V 
The semicolon designates sequential execution. The ampersand causes the preceding pipeline to 
be executed without waiting for it to finish. The process id of such a pipeline is reported, so that 
it may be used if necessary for a subsequent wait or kill. 

. Termination Resorting. If a command (not followed by 'A') terminates abnormally, a message is 
printed. (All terminations other than exit and interrupt are considered abnormal.) Termination 
reports for commands followed by '4' are given upon receipt of the first command subsequent to 
the termination of the command, or when a wait is executed. The following is a list of the ab- 
normal termination ~ 



Bus error 
TracsVBPT trap 
Illegal instruction 
IOT trap 
EMT trap 
Bed system call 
Quit 

Floating exception 
Memory violation 
Killed 

If a core image is produced, - Core dumped' is appended to the appropriate message. 

Redirection of I/O. There are three character sequences that cause the immediately following 
string to be interpreted as a special argument to the Shell itself. Such an argument may appear 
anywhere among the arguments of a simple command, or before or after a parenthesized com- 
mand list, and is associated with that command or command list 

An argument of the form *<arg' causes the file 'arg' to be used as the standard input rile of the 
associated command. 
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An argument of the form \>arg' causes file 'arg' to be used as the standard output file for the as- 
sociated command. 'Arg' is created if it did not exist, and in any case is truncated at the outset. 

An argument of the form >>arg' causes file 'arg' to be used as the standard output for the associ- 
ated command. If 'arg' did not exist, it is created; if it did exist, the command output is append* 
ed to the file. 

For example, either of the command lines 

Is >junk: cat tail >>junk 
( Is; cat tail ) >junk 

creates, on file 'junk', a listing of the working directory, followed immediately by the contents of 
file 'tail'. 

Either of the constructs ">arg' or > >>arg' associated with any but the last command of a pipeline 
is ineffectual, as is k <arg' in any but the first 

Generation of argument lists. If any argument contains any of the characters '?*, or f . it is 
treated specially as follows. The current directory is searched for files which match the given ar- 
gument 

The character in an argument matches any string of characters in a file name (including the 
null stringA 

The character T matches any single character in a Ale name. 

Square brackets %..V specify a class of characters which matches any single file-name character in 
the class. Within the brackets, etch ordinary character is taken to be a member of the class. A 
pair of characters separated by '-' places in the class each character lexically greater than or 
equal to the first and less than or equal to the second member of the pair. 

Other characters match only the same character in the file name 

For example. **' matches all file names; matches all one-character file names; '(abl* s' matches 
all file names beginning with 'a' or 'b' and ending with \s'; "la-mi' matches ail two-character 
file names ending with 'z' or the letters V through *m\ 

If the argument with or also contains a 7*, a slightly different procedure is used: instead of 
the current directory, the directory used is the one obtained by taking the argument up to the last 
*f before a or T. The matching process matches the remainder of the argument after this *F 
against the files in the derived directory. For example: Vusr/dmr/a's' matches ail files in directo- 
ry Vusr/dmr' which begin with 'a* and end with \s\ 

In any event, a list of names is obtained which match the argument This list is sorted into al- 
phabetical order, and the resulting sequence of arguments replaces the single argument containing 
the •". f , or '?'. The same process is earned out for each argument (the resulting lists are not 
merged) and Anally the command is called with the resulting list of arguments. 

For example directory /usr/dmr contains the Ales al.s. a2.s. ... a9.s. From any directory, the 
command 

as Aar/dmr/a? s 

calls as with arguments /usr/dmr/al.s. /usr/dmr/als. ... /usr/dmr/a9 s in that order. 

Quoclnf. The character *V causes the immediately following character to loss any special mean- 

mg it msy have to the Shell; in this way <\ >\ and other characters meaningful to the Shell 

may be passed as part of arguments. A special case of this feature allows the continuation of 

commands onto more than one line: a new-line preceded by 'V is translated into a blank. 

Sequences of characters enclosed in double O or single quotes are also taken literally For 

example: 

Is | pr -h "My directory" 
causes a directory listing to be produced by Is. and passed on to pe to be printed with the heading 
•My directory" Quotes permit the inclusion of blanks in the heading, which is a single argument 
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1. it has additional string processing 
i is 



sh [ name [ argi ... ( arg9 1 ) 1 

T ^\ na ^*!. s inc name of * ftle which wUI 136 retd 41,(1 interpreted. If not given, this subinstance 
of the Shell will continue to read the standard input ftle. 

In command lines in the file (not in command input), character sequences of the form Sn'. 
where n is a digit, are replaced by the mh argument to the invocation of the Shell (argn) SO' is 
replaced by name. 

End of Me. An end-of-AIe in the Shell's input causes it to exit. A side effect of this fact means 
that the way to log out from UNIX is to type an EOT. 

Speciti commands. The following commands are treated specially by the Shell. 

chdtr is done without spawning a new process by executing sys chdir (II). 

login is done by executing /bin/login without cresting a new process. 

wait is done without spawning a new process by executing sys wait (I IX 

shift is done by manipulating the arguments to the Shell. 

':' is simply ignored. 

Command file errors; internum. Any Shell-detected error, or an interrupt signal, during the ex- 
ecution of a command Ale causes the Shell to cease execution of that Ale. 

Process that are created with a 'aV ignore interrupts. Also if such a process has not redirected its 
input with a '<'. its input is automatically redirected to the zero length Ale /dev/null. 

FILLS 

/etc/glob, which interprets '**, '?', and T. 
/dev/null as a source of end-of-flle. 

SEC ALSO 

"The UNIX Time-sharing System', which gives the theory of operation of the Shell, 
chdirtt). logind), waitU). shiftd) 



When output is redirected, particularly to make a mulu command pipeline, diagnostics tend to be 
sent down the pipe and are sometimes lost altogether. Not all components of a pipeline 
swawned with 'aV ignore interrupts. 
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NAME 

SYNOPSIS 
DESCRIPTION 



goto — command transfer 
goto label 

goto is only allowed when the Shell is taking 
commands from a file. The file is searched (from 
the beginning) for a line beginning with fol- 
lowed by one or more spaces followed by the 
label . If such a line is found, the coto command 
returns. Since the read pointer in the command 
file points to the line after the label, the 
effect is to cause the Shell to transfer to the 
labelled line. 



: is a do-nothing command that only serves to 
place a label. 



PILES 
SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNS* 



Sh(I), 8(1) 

"goto error", if w the input file is a typewriter; 
"label not found". 
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NAME 

SYNOPSIS 

DESCRIPTION 



: place a label 

± [ label ] 

• does nothing. Its only function is to place 
Isabel for the goto command. ^ is a command so 
the Shell doesn't have to be fixed to ignore 
lines with : 's . 



FILES 

SEE ALSO goto( I) 

D IAGNOST ICS 

BUGS 



OWNER 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



stat — get file status 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



sys 



stat; name; buf / stat = 18 



77?! P 2 i 2 t ? *° a nul *-terminated string naming a 
file; buf is the address of a 34(10) byte buffer 
into which information is placed concerning the 

it fii unnecessar Y to have any permissions 

at all with respect to the file, but all direc- 
tories leading to the file must be readable. 

After stat, buf has the following format: 



buf, +1 
+ 2, +3 
+ 4 
+ 5 

+6, +7 
+8, +9 



i-number 

flags (see below) 
number of links 
user ID of owner 
size in bytes 

first indirect block or contents block 



lll'lll ^ „ eic ? hth indirect block or contents block 
+24, +25, +26, +27 creation time 

+28, +29, +30, +31 modification time 
+32, +33 unused 

The flags are as follows: 



always on 



100000 used (always on) 

040000 directory 

020000 file has been modified 

010000 large file 

000040 set user ID 

000020 executable 

000010 read, owner 

000004 write, owner 

000002 read, non-owner 

000001 write, non-owner 



fstat 

Error bit (c-bit) is set if the file cannot be 
found. 

The format is going to change someday, 
ken, dmr 
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NAME 

stat - get file sutus 

SYNOPSIS 

(stat - 18.) 

sys stat; name; buf 

statCname, buf) 
char *name; 
struct I node *buf; 

DESCRIPTION 

jVeme points to a null-terminated string naming a file; bu/ls the address of a 36(10) byte buffer in- 
to which information is placed concerning the file It is unnecessary to have any permissions at 
all with respect to the file, but all directories leading to the file must be readable. After stat buf 
has the following structure (starting offset given in bytes): 

struct ( 

char minor, 

char major, 

int inumber 

int flags; 

char niinks; 

char uid; 

char gid; 

char sizeO, 

int sizel; 

int addriSk 

int actime(2l; 

int modtimeLU 

The flags are as follows: 

10O0CO i-node is allocated 
060000 2-bit file type: 

000000 plain file 

040000 directory 

020000 character-type special file 

060000 block-type special file. 
010000 large file 
004000 set user-ID on execution 
002000 set group-ID on execution 
000400 reed (owner) 
000200 write (owner) 
000100 execute (owner) 
000070 read, write, execute (group) 
000007 reed, write, execute (others) 

SEE also . 

statd), fstatdft fsCV) 

DIAGNOSTICS 

Error bit (c-bit) is set if the file cannot be found. From C, a -r return indicates an error. 



r +0: minor device of i-node 7 
/• +1: major device */ 

r +2 •/ 

/• +4: see below 7 

r +6: number of links to file 7 

/* +7: user ID of owner 7 

r +8: group ID of owner 7 

/• +*. high byte of 24-bit size 7 

r +10: low word of 24-bit size 7 

/• +12: block numbers or device number 7 

r +28: time of last access 7 

/• +32: time of last modification 7 
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NAME 

stat, fstat - get file status 

SYNOPSIS 

#lncluda < sy •/ types. h> 
#include <syt/stat.h> 

stat (name, buf) 
char *name; 
struct stat *b«f; 

fstat(flldes, buf) 
struct stat *buf; 

DESCRIPTION 

Stat obtains detailed information about a named file. Fstat obtains the same information about 
an open file known by the file descriptor from a successful open, creau dup or piped) call. 

Name points to a null-terminated string naming a file; buf is the address of a buffer into which 
information is placed concerning the file. It is unnecessary to have any permissions at all with 
respect to the file, but all directories leading to the file must be searchable. The layout of the 
structure pointed to by buf as defined in <sut.h> is given below. St_mode is encoded accord- 
ing to the l #define' statements. 

stat 

dev_t st_dev; 

ino_t stjno; 
unsigned short st_mode; 

short st_nlink; 

short stjiid; 

short st _gid; 

devj st.rdev; 

offj st_size; 

timej st_atime; 

timej stjntime; 

time_t st_cume; 



struct 

( 



#defineS IFMT 0170000 
#define S IFDIR 0040000 

#define S IFCHR 0020000 

#deftoe S IFBLK 0060000 

#oaflne S IFREG 0100000 

#deAnt S IFMPC 0030000 

#dt£i» S IFMPB 0070000 

#deAneS iSUID 0004000 
#deflosS ISGID 0002000 
#defincS ISVTX 000 1 000 
#defioeS I READ 0000400 
#defineS I WRITE 0000200 
#defincS I EX EC 0000100 



/• type of file V 
/•directory V 
/" character special V 
/* block special V 
/• regular V 

/• multiplexed char special V 

/• multiplexed block special V 

/* set user id on execution V 

/* set group id on execution V 

/* save swapped text even after use V 

/• read permission, owner V 

/• write permission, owner V 

/• execute/ search permission, owner */ 



The mode bits 0000070 and 0000007 encode group and others permissions (see chmodiD). 
The defined types, ino_u off J. ume_u name various width integer values; devj encodes major 
and minor device numbers; their exact definitions are in the include file <sys/ types. h> (see 
<ypes(S). 
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When fildts is associated with a pipe, fstat reports an ordinary file wuh restricted permissions 
I he size is the number of bytes queued in the pipe. 

st_aume is the file was last read. For reasons of efficiency, it is not set when a directory is 
searched, although this would be more logical. st_mt,mt is the time the file was last written or 
created It is not set by changes of owner, group, link count, or mode, st cum is set both 
both by writing and changing the i-node. 

SEE ALSO 

ls(l). filsys(5) 

DIAGNOSTICS 

Zero is returned if a status is available; - 1 if the file cannot be found. 
ASSEMBLER 

(stat - 18.) 

sys stat; name; buf 

(fstat - 28.) 

(file descriptor in rO) 

sys fstat; buf 
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PIPE (II 



NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 

BUGS 



pipe — create a pipe 

■ye pipe / pipe « 42.; not in assembler 

(file descriptor in rO) 

The pipe system call creates an I/O mechanism 
called a pipe. The file descriptor returned can 
be used in both read and write operations. When 
the pipe is written, the data is buffered up to 
504 bytes at which time the writing process is 
suspended, A read on the pipe will picK up the 
buffered data. 



et 

ated 



It is assumed that after the pipe has been s 
up, two (or more) cooperating processes (ere- 
by subsequent fork calls) will pass data through 
the pipe with read and write calls. 

The shell has a syntax to set up a linear array 
of processes connected by pipes* 

Read calls on an empty pipe (no buffered data) 
with only one end (no synonymous file descriptors 
resulting from fork or dug) return an end-of- 
file. Write calls under similar conditions are 
ignored, 

sh(l) f read(ll), write(ll) t forK(Il) 

The error bit (c-bit) is set if 10 files are 
already open. 
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NAME 

SYNOPSIS 

DESCRIPTION 



intr — set interrupt handling 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



sys 



intr; arg 



/ intr = 27. 



When arg is 0, interrupts (ASCII DELETE) are 
ignored. When arg is 1, interrupts cause their 
normal result, that is, force an e xit . When arg 
is a location within the program, control is 
transferred to that location when an interrupt 
occurs. 

After an interrupt is caught, it is possible to 
resume execution by means of an rtl instruction; 
however, great care must be exercised, since all 
I/O is terminated abruptly upon an interrupt. In 
particular, reads of the typewriter tend to re- 
turn with characters read, thus simulating an 
end of file. 



quit 



It should be easier to resume after an interrupt, 
but I don't know how to make it work, 

ken, dmr 
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NAME 

signal — catch or ignore signals 

SYNOPSIS 

(signal - 48.) 

sys signal; slg; value 

signaKsig, tunc) 
Int (•funcX); 

DESOUPnON 

When the signal defined by sig is sent to the current process, it is to be treated according to 
value. The following is the list of signals: 



I 


hangup 


2 


interrupt 


3- 


quit 


4* 


illegal instruction 


5* 


trace trap 


6" 


IOT instruction 


V 


EMT instruction 


3 - 


floating point exception 


9 


kill (cannot be caught or ignored) 


10* 


bus error 


ir 


segmentation violation 


12* 


bad argument to sys call 



If value is 0, the default system action applies to the signal. This is processes termination with 
or without a core dump. If vaJue is odd the signal is ignored. Any other even value specifies an 
address in the process where an interrupt is simulated. An RTI instruction will return from the 
interrupt As a signal is caught, it is reset to 0. Thus if it is desired to catch every such signal, 
the catching routine must issue another signal call. 

The starred signals in the list above cause core images if not caught and not ignored. In C. if 
func is or I, the action is as described above. If func is even, it is assumed to be the address of 
a function entry point When the signal occurs, the function will be called. A return from the 
function will simulate the RTI. 

After a fork, the child inherits all signals. The exec call resets all caught signals to default action. 

SEE ALSO 

kill a, ID 

DIAGNOSTICS 

The error bit fc-bit) is set if the given signal is out of range. In C a -I indicates an error: indi- 
cates sniTsm 
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NAME stty — set mode of typewriter 

SYNOPSIS (file descriptor in rO) 

sys stty; arg / stty » 31. 
• • • 

arg: dcrsr; dcpsr; mode 



DESCRIPTION 



sttv sets mode bits for a typewriter whose file 
descriptor is passed in rO. First, the system 
delays until the typewriter is quiescent* Then, 
the^ argument dcrsr is placed into the typewri- 
ter's receiver control and status register, and 
dcoar is placed in the transmitter control and 
status register. The DC-11 manual must be con- 
sulted for the format of these words. For the 
purpose of this call, the most important role of 
these arguments is to adjust to the speed of the 
typewriter. 

The mode arguments contains several bits which 
determine the system's treatment of the 
typewriter: 

200 even parity allowed on input (e. g. for m37s 

100 odd parity allowed on input 

040 raw mode: wake up on all characters 

020 map CR into LF; echo L? or CR as LF-CR 

010 echo (full duplex) 

004 map upper case to lower on input (e. g. M3 3) 

002 echo and print tabs as spaces 

001 inhibit all function delays ( e. g. CRTs) 

Characters with the wrong parity, as determined 
by bits 200 and 100, are ignored. 

In raw mode, every character is passed bacfc im- 
mediately to the program. No erase or kill pro- 
cessing is done; the end-of-file character (EOT), 
the Interrupt character (DELETE) and the quit 
character (FS) are not treated specially. 

Mode 020 causes input carriage returns to be 
turned into new-lines; input of either CR or LF 
causes LF«<R both to be echosd (used for GS Ter- 
miNet 300' s and other terminals without the new- 
line function ) . 

Additional bits in the high order byte of the 
mode argument are used to Indicate that the ter- 
minal is an IBM 2741 and to specify 2741 modes. 
These mode bits are: 
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4000 use correspondence code conversion on input 
(currently ignored) 

Normal input and output code conversion for 2741 s 
is EBCDIC (e. g. 963 ball and corresponding key- 
board). The presence of the transmit interrupt 
feature permits the system to do read-ahead while 
no output is in progress. In 2741 mode, the low 
order bits 331 are ignored. 

FILES 

SEE ALSO stty(I), gtty( II ) 

DIAGNOSTICS The error bit (c-bit) is set if the file descrip- 
tor does not refer to a typewriter . 

BUGS This call should be used with care. It is all 

too easy to turn off your typewriter. 

owner ken, drar 



V 
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NAME 

ioctl, stty, gtty - control device 

SYNOPSIS 

#include <sgtty.h> 

ioctl (Aides, request, argp) 
struct sgttyb *argp; 

stty(flldes, argp) 
struct sgttyb 'argp; 

gtty (Aides, argp) 
struct sgttyb *argp; 

DESCRIPTION 

Ioctl performs a variety of functions on character special files (devices). The writeups of vari- 
ous devices in section 4 discuss how ioctl applies to them. 

For certain status setting and status inquiries about terminal devices, the functions s/rvand 2,rv 
are equivalent to 7 * y 

ioctKAldts. TIOCSETP. argp) 

ioctKAldes, TIOCGETP, argp) 

respectively; see /ry(4). 

The following two calls, however, apply to any open file: 

ioctKAldes, FIOCLEX, NULL); 
ioctKAldes. FIONCLEX, NULL); 

The first causes the file to-be closed automatically during a successful exec operation- the 
second reverses the effect of the first. 

SEE ALSO 

stty(l). tty(4). exec(2) 

DIAGNOSTICS 

Zero is returned if the call was successful; - 1 if the file descriptor does not refer to the kind of 
me for which it was intended. 

BUGS 

Strictly speaking, since ,octl may be extended in different ways to devices with different proper- 
ties, argp should have an open-ended declaration like 

union { struct sgttyb ... J •irgp; 

The important thing is that the size is fixed by 'struct sgttyb'. 
ASSEMBLER 

(ioctl - 54.) 

sys ioctl; Aides; request; argp 

(stty - 31.) 

(file descriptor in rO) 

stty; argp 

(guy - 32.) 

(file descriptor in rO) 

sys gtty; argp 
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NAME 

printf - formatted print 

SYNOPSIS 

prinrfTfonnat, arg,, ...); 
char 'format; 

DESCRIPTION 

Printf converts, formats, and prints its arguments after the first under control of the first argu- 
ment. The first argument is a character string which contains two types of objects- plain charac- 
ters, which are simply copied to the output stream, and conversion specifications, each of which 
causes conversion and printing of the next successive argument to printf. 

Each conversion specification is introduced by the character %. Following the %, there may be 

- an optional minus sign k - which specifies left adjustment of the converted argument in the 
indicated field; 

- an optional digit string specifying a field width; if the converted argument has fewer char- 
acters than the field width it will be blank-padded on the left (or right, if the left- 
adjustment indicator has been given) to make up the field width; 

- an optional period V which serves to separate the field width from the next digit string; 

- an optional digit string (precision) which specifies the number of digits to appear after the 
decimal point, for e- and f-conversion, or the maximum number of characters to be print- 
ed from a string; 

- a character which indicates the type of conversion to be applied. 
The conversion characters and their meanings are 

d The argument is converted to decimal notation. 

The argument is converted to octal notation. "0" will always appear as the first digit. 

f The argument is converted to decimal notation in the style "Hdddddd" where the 
number of d's after the decimal point is equal to the precision specification for the argu- 
ment. If the precision is missing, 6 digits are given; if the precision is explicitly 0, no di- 
gits and no decimal point are printed. The argument should be float or double. 

e The argument is converted in the style u Hd.ddde±dd" where there is one digit before 
the decimal point and the number after is equal to the precision specification for the 
argument; when the precision is missing, 6 digits are produced. The argument should be a 
float or double quantity. 

c The argument character or character-pair is printed if non-null. 

s The argument is taken to be a string (character pointer) and characters from the suing are 
printed until a null character or until the number of characters indicated by the precision 
specification is reached; however if the precision is or missing all characters up to a null 
are printed. 

1 The argument is taken to be an unsigned integer which is converted to decimal and print- 
ed (the result will be in the range to 6553SX 

If no recognizable character appears after the %, that character is printed; thus % may be printed 
by use of the string %%. In no case does a non-existent or small field width cause truncation of 
a field; padding takes place only if the specified field width exceeds the actual width. Characters 
generated by printf arc printed by calling putchar. 

SEE ALSO 

putchar (III) 
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PUTC, PUTW, FCREAT, FLU Sr. (Ill 



NAME 
SYNOPSIS 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



putc, putw, fcreat, flush — buffered output 

mov 5 filename , rO 

jsr r5, fcreat; iobuf 

(get byte in rO) 

jsr r5,putc; iobuf 

( get word in rO ) 

jsr r 5, putw; iobuf 



jsr 



r5, flush; iobuf 



fcreat creates the given file (mode 17) an' 3 , sets 
up the buffer i ohuf (size 134(10) bytes); cut e 
and putv write a byte cr word respectively onto 
the file; flush forces the contents of the buffer 
to be written, but does not close the file. The 
format of the buffer is: 



iobuf : 



. =.+2 
.=.^2 
.=.+128. 



/ file descriptor 
/ characters unused in buff' 
/ ptr to next free charactei 
/ buffer 



fcrea t sets the error bit (c-bit) if the file 
creation failed* none of the other routines re- 
turn error inf creation . 

Before terminat xna, a crcqrajr should call flus h 
tc force out the last of the output. 

The user rrust supply i ohuf . which shcul J \-*~ir ■ 
a word boundary. 

kept in /etc/lioa.a 

sys creat; sys writ*; getc, getw, 

error bit possible on f cr ea t call 

buffers should be chanred to 5 1 2 bytes. 

dmr 
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NAME 

stdio - standard buffered input/output package 

SYNOPSIS 

#include < stdio. h> 

FILE *stdin; 
FILE "stdout; 
FILE •stderr; 

DESCRIPTION 

The functions described in Sections 3S constitute an efficient user-levei buffering scheme. The 
in-line macros getc and putcO) handle characters quickly. The higher level routines gets. /gets, 
scan/, fscanf, fread, puis, /puts, print/, /print/, /write all use getc and putc; they can be freely inter- 
mixed. 

A file with associated buffering is called a stream, and is declared to be a pointer to a defined 
type FILE. FopenO) creates certain descriptive data for a stream and returns a pointer to desig- 
nate the stream in all further transactions. There are three normally open streams with con- 
stant pointers declared in the include file and associated with the standard open files: 

stdin standard input file 
stdont standard output file 
stderr standard error file 

A constant 'pointer* NULL (0) designates no stream at all. 

An integer constant EOF (-1) is returned upon end of file or error by integer functions that 
deal with streams. 

Any routine that uses the standard input/output package must include the header file 
<stdio h> of pertinent macro definitions. The functions and constants mentioned in sections 
labeled 3S are declared in the include file and need no further declaration. The constants, and 
the following 'functions' are implemented as macros; redeclaration of these names is perilous: 
getc, getchar, putc, putchar, /eo/, /error, file no. 

SEE ALSO 

open(2), close(2), read(2), write(2) 

DIAGNOSTICS 

The value EOF is returned uniformly to indicate that a FILE pointer has not been initialized 
with /open, input (output) has been attempted on an output (input) stream, or a FILE pointer 
designates corrupt or otherwise unintelligible FILE data. 
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NAME 
SYNOPSIS 
DESCR IPT ION 



FILES 



SEE ALSO 
D LAGNOST ICS 
BUGS 
OWN BP 



cc — C compiler 

cc [ z£ ] »fU« ljB s ... ofile 1 ... 

cc ts the UNIX C compiler. it accepts three 
types of arguments: 

Arguments whose names end with ".c" are assumed 
to be C source programs; they are compiled, and 
the object program is left on the file sf ile 1 .o 

of the source 



(i.e. w the file whose name is that 
with .o substituted for w .c"). 



Other arguments (except for "-e") are assumed to 
be either loader flag arguments, or C-compatible 
object programs, typically produced by an earlier 
cc run, or perhaps libraries of C-compatible 
routines. These programs, together with the 
results of any compilations specified, are loaded 
(in the order given) to produce an executable 
program with name a .out . 

The "-c" argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 



file.c 

a.out 

c.tmp 

/sys/c/nc 

/usr/lib/crtO.o 

/usr/lib/libc.a 

/usr/lib/liba.a 



input file 

loaded output 

temporary (deleted) 

compiler 

runtime star toff 

built in functions, etc. 

system library 



C raferenca manual (in preparation ) , bc(vi) 
Diagnostics are intended to be self-explanatory. 



dar 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



DIAGNOSTICS 



BUGS 



yacc — yet another compiler compiler 
/crp/sc 1/vacc [ <grammar ] 

Yacc converts a context-free grammar into a set 
of tables for a simple automaton which executes 
an LR(1) parsing algorithm. The tables are pro- 
vided in readable form on the standard output and 
in b-compiler format on file actn.b; the program 
/crp/sc j/bpar.b will parse strings using the 
actn.b file. 

If your grammar is too big for yacc, you may try 
/crp/sc j/bigyacc, some of whose size limits are 
larger, and others smaller. 

actn.b output tables 

actn.tmp temporary storage 

Note that these files are created in the 

invoker's directory. The file actn.tmp is only 

created by /crp/sc j/bigyacc (see above). 

Yacc manual, by scj (available from ek)j "lr 
Parting , by A • V . Aho and S. C. Johnson, to be 
published. 

There are various diagnostics, but only one can 
be obtained in each run. 

The maximum number of terminal and non-terminal 
symbols is 50 each, and this is not checked. 
There are undoubtedly other bugs too. 
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FORM 



NAME 

SYNOPSIS 
DESCRIPTION 



FILES 



form — form letter generator 
form proto arg 1 ... 

fo rm generates a form letter from a prototype 
letter, an associative memory, arguments and in a 
special case, the current date. 

If form is invoiced with the argument x, the fol- 
lowing files come into play: 

x.f prototype input 
x.r form letter output 
x.am associative memory 

form. am associative memory if x.am not found. 

Basically, form is a copy process from the file 
x.f to the file x.r. If an element of the -form 
\n (where n is a digit from 1 to 9) is encoun- 
tered, The~nth argument is inserted in its place, 
and that argument is then rescanned. If \0 is- 
encountered, the current date is inserted. If 
the desired argument has not been given, a mes- 
sage of the form "\n: " is typed. The response 
typed in then is used for that argument. 

If an element of the form [name] is encountered, 
the name is looked up in the associative memory. 
If it is found, the contents of the memory under 
this name replaces the original element (again 
rescanned.) If the name is not found, a message 
of the form "name: " is typed. The response 
typed in is used for that element. If the asso- 
ciative memory is writable, the response is en- 
tered in the memory under the name. Thus the 
next search for that name will succeed without 
interaction. 

In both of the above cases, the response is typed 
in by entering arbitrary text terminated by two 
new lines. Only the first of the two new l. 4 nes 
is passed with the text. The process is instant- 
ly terminated if an end of file is encountered 
anywhere except in the associative memory. 



x.f 
x.r 
x. am 
form . am 



input file 
output file 
associative memory 
associative memory 



SEE ALSO 
DIAGNOSTICS 



type 

"settup error" when the appropriate files cannot 
be located or created. 



BUGS 



settup is misspelled. 
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TYPO (I 



NAME 

SYNOPSIS 
DESCRIPTION 



typo — find possible typo's 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



typo [ - ] file 



typo hunts through a document for unusual words, 
typographic errors, and hapax legomena and prints 
them on the standard output. 

All words used in the document are printed out in 
decreasing order of peculiarity along with an 
index of peculiarity. An index of 10 or more is 
considered peculiar. Printing of certain very 
common English words is suppressed. 

The statistics for judging words are taken from 
the document itself; with some^help from Known 
statistics of English. The option suppresses 

the help from English and should be used if the 
document is written in, for example, Urdu. 

Roff and Nroff control lines are ignored. Upper 
case is mapped into lower case. Quote marks, 
vertical bars, hyphens, and ampersands are 
stripped from within words. Words hyphenated 
across lines are put back together. 

/tmp/ttmp??, /etc/salt, /etc/w2006 



yes, lots 

Because of the mapping into lower case and the 
stripping of special characters, words may be 
hard to locate in the original text. 



ov 
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OV 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



ov — overlay pages 
ov [ file ] 

ov is a postprocessor for producing double column 
Formatted text when using nroff(l). ov literally 
overlays successive pairs of 66-line pages. 

If the file argument is missing, the standard 
input is used. Thus ov may be used as a filter. 

none 

nroff(l), pr(l) 
none 

Other page lengths should be permitted. 
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SAME 

wwb. style, diction, punct - writers workbench 
SYNOPSIS 

ww* style [ option 1 ... file ... 

ww* dktioa ( option 1 ... file ... 
wwfc suggest 

file ... 

[-■•II 1 file ... 

DESCRIPTION 

Wwb controls many subprograms documented in the references. For the full treatment use "wwb 
wwb , but for quick use the following subprograms are recommended. 

Style reports on readability, sentence length tnd structure, word length and usage, verb type and 
sentence openers in the named documents. . ^ 

Diction prints all sentence, that contain phrases from a list of bad or verbose word patterns. Option 

-p pftle supplies an additional private pattern file; option -■ skips the standard one. 

Suggest reads, from the standard input, phrases deprecated by diction and proposes alternatives. 

/W reports sentences that appear to violate standard punctuation rules and sentences that contain 
doubled words. 

Style and diction expect documents prepared for nroffltroffd) and the preprocessors pic ideal 
grap, eqn. refer, and tbHl). Option -mm overrides the default macro package, -sm The related 
option -mi skips mm-style lists, and should be used if there are many lists of non-sentences. 
Other options for style are: 

-a print all sentences with their length and readability index, 
-t print all sentences that begin with an expletive. 
" * print all sentences that contain a passive verb. 
-Inum print all sentences longer than num. 

-tnum print all sentences whose readability index is greater than num. 
-P print parts of speech of the words in the document. 
SEE ALSO 

deroff(l), speli(l) 

Writer's Workbench User's Manual. /usr/man/manw/* 

BUGS 

Use of non-standard formatting macros may cause incorrect sentence breaks. 
Imperatives cannot be recognized. 
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NAME 

sky - obtain ephemerides 

SYNOPSIS 

sky 

DESCRIPTION 

Sky predicts the apparent locations of the Sun, the Moon, the planets out to Saturn, stars of mag- 
nitude at least 2.5, and certain other celestial objects including comet Kohoutek and M31. Sky 
reads the standard input to obtain a GMT time typed on one line with blanks separating year, 
month number, day, hour, and minute; if the year is missing the current year is used. If a blank 
line is typed the current time is used. The program prints the azimuth, elevation, and magnitude 
of objects which are above the horizon at the ephemeris location of Murray Hill at the indicated 
time. 

Placing a "1" input after the minute entry causes the program to print out the Greenwich Sidere- 
al Time at the indicated moment and to print for each body its right ascension and declination as 
well as its azimuth and elevation. Also, instead of the magnitude, the geocentric distance of the 
body, in units the program considers convenient, is printed. (For planets the unit is essentially 
A. U.) 

The magnitudes of Solar System bodies are not calculated and are given as 0. The effects of at- 
mospheric extinction are not included; the mean magnitudes of variable stars are marked with 

urn** 

For all bodies, the program takes into account precession and nutation of the equinox, annual 
(but not diurnal) aberration, diurnal parallax, and the proper motion of stars (but not annual 
parallax). In no case is refraction included. 

The program takes into account perturbations of the Earth due to the Moon, Venus, Mars, and 
Jupiter. The expected accuracies are: for the Sun and other stellar bodies a few tenths of seconds 
of arc; for the Moon (on which particular care is lavished) likewise a few tenths of seconds. For 
the Sun, Moon and stars the accuracy is sufficient to predict the circumstances of eclipses and oc- 
cultations to within a few seconds of time. The planets may be off by several minutes of arc. 

Information about the program may be obtained from its author. 

FILES 

/usr/lib/startab, /usr/lib/moontab 
SEE ALSO 

azel(VI) m , c j 

American Ephemeris and Nautical Almanac, for the appropriate years; also, the Explanatory Supple- 
ment to the American Ephemeris and Nautical Almanac. 

AUTHOR 

R. Morris 
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NAME 

wwv - print and set the date from accurate clock 

SYNOPSIS 

ww? ( -b -s -f -u ) 

DESCRIPTION 

wwv connects to a clock synchronized with radio station WWV. With no argument it prints the 
time obtained. It accepts these arguments: 

-b Print both the WWV time and the system's current idea of the time. 

-s Set the system's time to agree with WWV. You must be super-user. The system time can- 
not be changed by more than 20 minutes. 

-f With -s. force the time to be set by WWV even if the local time disagrees by more than 20 
minutes. 

-u Report time in UTC rather than local time. 

FILES 

/usr/adm/wtmp to record time-setting 

SEE ALSO 

date (1), utmp(5) 

BUGS 

The WWV clock has been observed to slip sync by an integral number of minutes or hours from the 
radio standard. 
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NAME 

cdl - circuit description language 
DESCRIPTION 

The circuit descriptions used by design aid programs place, wcheck, bdraw and wrap are 
expressed in the Circuit Design Language described below. A complete description has four 
main parts which must appear in the sequence: Package Descriptions, Board Description. Com- 
ponent Descriptions, then Circuit Description. The last of these can be generated automatically 
from circuit drawings made by the command draw. 

The elements of a circuit are as follows. 

signal The information that passes over a wire and is carried by a net of wires, 

chip A circuit component. 

package The physical unit which houses one or more chips, 

pin The point where a signal wire connects to a chip, 

board The physical unit on which packages are mounted, 

socket The device for mounting a package on a board. 

connector The interface between signal wires on the board and those external to the board. 

Chips, packages and sockets are grouped by type. All the items of one type exhibit the same 
properties. Types, like signals, chips and connectors, are identified by name. Pins and sockets 
are identified by number. 

A name is a string of up to 16 letters, digits or any of the symbols + — .5 with the restriction 
that the first character cannot be a digit. In the simplest case, no two names can be the same 
but there is provision for dividing a circuit into modules so that a name in one module is not 
confused with the same name appearing in another module. A name that is defined prior to the 
first .in command is global and must be unique. (The description of a module starts with .m 1 
A name defined within a module is a local name and must not be the same as either another 
name local to the same module or a global name. The full form of a local name consists of the 
module name and the local name separated by a /. It cannot be longer than 16 characters. 
Within the text of one module description it is possable to refer to an element of another 
module by giving its full name. A name prefixed with is a global name. 

The circuit board and components mounted on it are described as rectangles. They are posi- 
tioned so that their sides are parallel to one or other of the axes used to describe circuit board 
geometry. The axes should be chosen so that the following are true. 

The origin of the coordinate system lies outside the board and the board is in the first 
quadrant 

When the board is loaded with dual-in-line packages, pin one of a package is the closest 
pin to the board origin. 

The rows of pins on dual-in-line packages- run parallel to the X axis. 

Measurements are expressed in hundredths of an inch. All are integers and have no explicit 
decimal point. Coordinates are expressed as pairs of integers spearated by 7\ The X coordi- 
nate appears first. 

It is sometimes necessary to provide a list of coordinates. Invariably each coordinate is associ- 
ated with a numbered item (pin number, socket number etc.). A one item list consists of the 
item number followed by its coordinates as in 
28 170/250 

A series of equally spaced and consecutively numbered items can be described by giving the 
first and last item descriptions and separating the two with as in 

28 170/250 - 30 190/200 
(item number 29 appears at position 180/225). If the item numbers are equally spaced but not 
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consecutive a step size can follow the as in 

12 200/700 -9 147 200/100 
(which describes the positions of items numbered 12. 21, 30 etc.) 

In the following list of commands, characters that must appear are written in bold type while 
character strings are identified by names in italics. Brackets ( and ] enclose an optional item and 
vertical bar I indicates an alternative. A list of items and coordinates, written as described in the 
previous paragraph, is represented by 

setoff //vm coordinate] 

Commands are separated by either newline or semi-colon. A comment can appear on any line. 
It starts with a % and ends with a newline. 

Lines that do not start with a period are signal definition lines. They have the format 

name (pin) ... | name [«■ signaA 
The signal called name is described either as being connected to one or more pins, or is 
described as being equivalent to a previously described signal. Signal descriptions of this form 
can appear after ,c commands, in which case the pin numbers refer to pins on a chip, or they 
appear after .i and .o commands, in which case the pins are those on a connector. 

The commands are as follows. 

Package Description 

.k name pins length width 

Define package type. Arguments are the package type name, the number of pins on each pack- 
age, and its overall dimensions. The length is the distance along the X axis and the width is the 
distance along the Y axis. Note: the pins for a package should be numbered consecutively from 
one even if that means inventing a few extra pins. 

.kp seiofipmno coord] 

Package pin locations. One or more .kp commands following a .k command gives the list of 
pins and their coordinates relative to the origin of the package. (By convention, the origin of a 
dual-in-line package is that corner of the package closest to pin number one.) 

Board Description 

.b name sockets connectors Define a circuit board. Arguments are board name, the number of 
sockets on the board, and the number of I/O connectors. 

.bs rotation coord 

Board Orientation. A .be command gives the orientation of the board relative to that used 
when the board is placed in a wire-wrap machine. A • indicates that the board description is 
with the pins pointing up. A + is used when the board is described from the component side. 
Coord is the board location of the wiring machine's origin and rotation is the number of right- 
angles by which the board must be rotated anti-clockwise about the wiring machine's origin in 
order to bring the board into the first quadrant. 

.s name [package] ... 

Define a socket type. Arguments are the socket type name and a list of the package types that 
can be located in the socket. The first package listed should be that whose pin numbering is the 
same as is used on the socket. 

.sb seto(\ sockerno coord] 

Socket locations. One or more .sb commands following a ,s command give the list of sockets 
mounted on the circuit board. Each socket has a number and board location. The socket 
numbers must run consecutively from one. The position of a socket is that of the corner 
nearest to the board origin., .x name pins length width 

Define Input/Output Connector. Arguments are the name of the connector, the number of 
pms. and its overall dimensions. The length is the distance along the X axis and the width is the 
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distance along the Y axis. Note: the pins for a connector should be numbered consecutively 
from one even if that means inventing a few extra pins. 

.xb coord 

Connector location. The coord is the board position of the connector. That is the position of 
the corner nearest to the board origin. 

xp sctofl pin no coord] 

Connector pin positions. One or more .xp commands following a .x command gives the list of 
pins and their coordinates relative to the position of the connector. 

.v number name 

Define special signal. The special signals are numbered consecutively from zero. The argu- 
ments for a .v are the special signal number and the signal name to which it corresponds. 

.vb setof {pinno coord] 

Special signal pin positions. One or more .vb commands following a .v command give the list 
of pins and their positions on the circuit board. The pins should be numbered consecutively 
from one. 

Chip Type Description 

.t name package [pinno] ... | .t name m type 

Define a chip type. Arguments are the chip type name, the name of the package in which it is 
installed, and pin numbers, pinno. for the special voltage connections. The special voltage pin 
numbers can be omitted if none are to be wired but if any are present they must be in the same 
sequence with which the special signals are numbered. (See .v command above.) A .t com- 
mand can be used to give an alternate name to a chip type. In that case the alternate name 
should be followed by equals and then the already defined type name. 

.to [pinno] ... 

Chip output pins. One or more .to commands following a .t command give the numbers of 
pins that carry output signals from the chip. 

Circuit Description 

name Start a module. The module 

is given as argument. All unqualified chip and signal names (no 7') in subsequent text are 
presumed to belong to this module. 

•P page no 

Start a page. The page number is pageno. 
.c name (typtl | .c name m chip 

Describe a chip. If the chip has been previously described one can give just one argument, the 
chip name. Otherwise one must give the chip name and chip type, or the chip name and the 
name of a previously described chip. In the latter case the two chips will be treated as one. Sig- 
nal descriptions following a .c command refer to pins on the chip. 

.c(h | s) socket no 

Chip placement. Socketno is the number of the socket into which the chip described in a previ- 
ous -c command is to be placed. A hard placement, specified by .ch. will not be changed by 
automatic placement programs whereas a soft placement, specified by .cs. will. A placement 
specified by a .cu command is a dummy that is used to describe chip grouping only In all 
cases, chips assigned to the same socketno occupy a single package. 

,J name 

Circuit board inputs. The connector name is given as argument. Signal descriptions following 
this command refer to signals originating outside the circuit board and the pin numbers -re 
connector pin numbers. 
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.0 name 

Circuit board output. The connector name is given as argument. Signal descriptions following 
this command refer to signals originating on the circuit board and the pin numbers are connec- 
tor pin numbers. 

.h signal 

Hand wired signal. The argument is the name of a signal that will be ignored by an automatic 
wiring program. 

■ u 

Un-fix chip positions. Chip positions defined with previous .ch, .cs or .cu commands will have 
no effect on the placement. However, grouping of chips will remain unchanged. 

A 

End of file. Not usually necessary. 
SEE ALSO 

draw(l), wcheck(l), wrap(l). placed), bdraw(l) 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
RUGS 



tss — interface to Honeywell TSS 

tS3 

tss will call the Honevwell 6070 on the 201 data 
Dhone. It will then go into direct access with 
TSS. OutDut generated by TSS is tyoed on the 
standard outout and input requested by TSS is 
read from the standard inout with UNIX tyoing 
conventions. 

An^interruot signal ( ASCII DEL ) is transmitted as 
a "break" to TSS. 

Inout lines beginning with J, are interDreted as 
UNIX commands. Inout lines""beginn ing with ~ are 
interoreted as commands to the interface routine. 

~<file insert input from named UNIX file 

"*>file deliver tss outout to named UNIX file 

~p pop the outDUt file 

~q disconnect from tss (quit) 

~r file receive from HIS routine CSR/DACCOPY 

~s file send file to HIS routine CSR/DACCOPY 

Ascii files may be most eff icientlv transmitted 
using the HIS routine CSR/DACCOPY in this 
fashion. Underlined text comes from TSS. 
AFTname is the 6070 file to be dealt with. 

SYSTEM? CSR/DACCOPY (s) AFTname 
Send Encoded File ~s file 

SYSTEM ? CSR/DACCOPY (r) AFTname • 
Receive Encoded File ~r file 

/dev/dnO , /d ev/doO 



DONE when communication is broken. 

When diagnostic Droblems occur, tss exits rather 
abruotly. 



OWNER 
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NAME 

nfs - communicate with Spider File Store 

SYNOPSIS 

nfs -key [ name ... 1 

DESCRIPTION 

Nfs saves and restores selected portions of the file system hierarchy in the Spider File 
Store(FS). Its actions are controlled by the key argument. The key is a string of characters 
preceded by '-' and containing at most one function letter and possibly one or more function 
modifiers. Other arguments to the command are file or directory names specifying which files 
are to be transfered, or listed. If no name is given, V is the default. 

The name arguments serve a dual role when a file is being transfered between UNIX and 
FS. In UNIX they are interpreted as usual with respect to the current directory, in the \ . . 
Store, they are interpreted with respect to the user's directory (as specified in the File Store 
password list). Thus, if the user k abc' has a FS login directory abc, the file names in the argu- 
ment refer to files in the FS directory abc regardless of the current UNIX directory. For exam- 
ple, if the user abc's current working directory is /usr/ hem/ second and he invokes 

nfs -w x y 

the files x and y of /usr/hem/second are sent to the FS files /abc/x and /abc/y. 

If c is used the arguments are interpreted with respect to a named directory; if V is used the FS 
interprets the files names with respect to the current working UNIX directory. For example, if 
abc's working directory is /usr/abc/sub/dir and he invokes 

nfs -w. x y 

the files are put on FS /abc/sub/dir/x and /abc/sub/dir/y. Without the V option they are . 
to the FS /abc/x and /abc/y. Normally, when a directory name is specified it denotes the con- 
tents of that directory. If x is used then the directory name denotes the directory itself. 

Each time that nfs is used the user is logged into the File Store and for this purpose his current 
user name (login) under UNIX is used. 

The function portion of the key is specified by one of the following letters: 

w Write the indicated files and directories to the File Store. If files with the same names 

already exist, they are replaced. 

u Update the File Store, u is the same as w, but a file is replaced only if its modification 

date is later than the date stored in the File Store; i.e. if it has changed sirce it was last 
written there. 

d Delete the named files and directories from the File Store. At least one name at s _ 

mem must be given. 

r Read the named files from the FS and write them into the UNIX file system. 

t List the titles of all items in the named directories. The complete tree is given. 

Names begining with V are not listed. If a file name is specified that name is typed 
back but only if the file exists in the FS. 

I List is the same as t but more information about each file and directory is given. 

s The space allocation and amount of space used for the account associated with euwn 

named directory is given. 

m Make a new directory in the FS. 
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FILES 



The following characters may be used in addition to the letter which selects the function 
desired. 

c The current directory in the file store is specified in the first name argument. 

The FS has the same working directory as the user has on UNIX. 

v Set verbose mode. Normally nfs does its work silently. The v option causes it to 

type the name of each file it treats preceded by the function letter. 

1 Set interactive mode. In this mode nfs pauses before treating each file, types the 

indicative letter and the file name, and awaits the user's response. Response y 
means 'yes', so the file is treated. Null response means 'no', and the file does not 
take part in whatever is being done. Response x means 'exit': the nfs command ter- 
minates immediately. 

x Set explicit mode. In this mode directory names denote the directories and not their 

contents (as is normal). 

T Temporary files are created. This option is used for files which are transient on the 

FS and do not need tape backup. 

B Large files have their space allocated in tracks, 

/dev/tiu 



sec ALSO 

ufs(l) 
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NAME 

dcon. ndcon. rx. rogin. rsh - remote login and execution 

SYNOPSIS 

dcon ( option J ... machine 

ndcon machine 

rx machine ( command-list ] 

/usr/bin/m/machine [ command-list ] 

/usr/inet/bin/rogia machine [ —I username ] 

/usr/inet/bin/rsn machine I -I username ) ( command-list 1 

DESCRIPTION 

Dcon logs in to the computer whose Datakit address is machine. It is much like cu(l), but the only 
local escapes are hang up ".' and a shell escape '"!*. 

Dcon normally tries to log in automatically, using the login id of the invoking user. To login expli- 
citly, or to connect to machines that disallow such access, use option -I. Other options are: 

-? Verbose. Give play-by-play while logging in. 

-s Script. The machine argument names a file that guides login. The first line of the file is 
the machine name. Later lines are paired: a prompt word expected from the remote 
machine (including nonblank punctuation), with an input line to send upon receiving that 
prompt. All other words received while looking for prompts are ignored. 

Ndcon logs in to a remote computer similarly to dcon. but with a direct stream (4) -to-stream con- 
nection. In particular mux (9) layers may be downloaded across it. The only local escape is the 
quit signal (controlA). Legitimate answers to the subsequent prompt "dcon> >' are T (sic) to send 
the quit signal to the remote machine. '%' or V to exit ndcon, and 'Icommand-list' to execute com- 
mands locally. 

Rx invokes a shell on the designated machine and passes the command-list to that shell The stan- 
dard input and output of the remote process are the standard input and output of rx. The standard 
error file from the remote process is the same as the standard output. The current directory, per- 
missions and shell variables of the remote shell are what the user would get by logging in directly. 
Unquoted shell metacharacters are interpreted locally; quoted ones are interpreted on the remote 
machine. 

Rx with no command-list is equivalent to 'dcon machine'. 

Directory lusribinlm contains machine names as commands: 7usr/bin/m/machine* with no argu- 
ment gets an ndcon connection; with arguments it does rx. If the directory is in the sh(\) search 
path, the names become commands for navigating the local cluster. 

Rogin and rsh are to ARPA internet as dcon and rx are to Datakit. A file \r hosts' in the login 
directory for username on a receiving machine lists machine/user pairs that may log in as username 
without a password check. Pairs appear one per line separated by blanks. 

EXAMPLES 

rx overthere cat file I > file2 

coptes remote file! to local file2: for other ways to do the job. see push(\) and n/s(S) 

rx overthere cat file I ">" file2 

copies remote file I to remote file 2 

FILES 

/usr/inet/lib/ - 

/usr/inet/lib/hosts.equiv list of machines with identical users 
S HO ME/r hosts 
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NAME 

SYNOPSIS 

DESCRIPTION 



su — become privileged user 
su password 

su allows one to . become the super-user, who has 
all sorts of marvelous powers. In order for su 
to do its magic, the user must pass as an argu- 
ment a password. If the password is correct, su 
will execute the shell with the (J ID set to that 
of the super-user. To restore normal UID 
privileges, type an end-of-file to the super-user 
shell . 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



shell 

"Sorry" if password is wrong 
dmr, fcen 
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NAME 

su - substitute user id temporarily 
SYNOPSIS 

/ttc/sn ( uscrid ) 

DESCRIPTION 

tolT!!^ K° f th t SPedfied w ^ and if 11 is « iven ' chan «« 10 and 

xceoffor HOME and SHFM ^ diWCt0ry ' ^ UMr i, unchanged 

except for HOME and SHELL. wh.ch are taken from the password file for the user being subsu- 
tuted (see mWam<5». The new user ID suys in force until the Shell exiu. 

sui^r ^1^^^ T ° ren " nd ^ mP "-™ °' * «*» «■ Shell 
SEE ALSO 

$h(l) 
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CRYPT 



NAME 

SYNOPSIS 
DESCRIPTION 



crypt — encode/decode 
crypt [ password ] 

crypt is an exact implementation of Boris 
Hagelin s cryptographic machine called the M-209 
by the U. S. Army [1]. 

crypt reads from the standard input file and 
writes on the standard output. For a given pass- 
word, the encryption process is idempotent; that 

crypt znorkle <clear >cypher 
crypt znorkle <cypher 

will print the clear. 

crypt is suitable for use as a filter: 

pr <" crypt bandersnatch w <cypher 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



[1] U. S. Patent 2,089,603. 
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NAME 

crypt, encrypt, decrypt - encode/decode 
VNOPS1S 

/usr/gamaa/crypt [ password ) 

/uar/gaaea/ancrypt ( -p ] [ password ] 
/uar/gaaea/dacrypt ( -p j [ password J 

DESCRIPTION 

These commands read from the standard input and write oa the standard output. The password is 
an enciphering key. If no password is given, one is demanded from the terminal; echoing is turned 
off while it is being typed in. Crypt uses • relatively simple, fast method (rotor machine) for both 
enciphering and deciphering. Encrypt and decrypt use a more robust, slower method (DES). Files 
enciphered by crypt ire compatible with those treated by the editor td in encryption mode. Files 
enciphered by crypt are not intelligible to encrypt) 'decrypt, and vice versa. 

It is prudent to supply the key from the terminal, not from the command line, and to pick a reason- 
ably obscure and long key (6 letters for crypt and much longer for encrypt). 

Under option -p encrypt enciphers into printing characters, which can be sent by mail (I). Decrypt 
can distinguish cipfaertext from clear it will work on a full mail, message, headers and all. 

FILES 

/dev/tty for typed key 
SEE ALSO 

ed(\), makekey(%) 



JGS 



J. A. Reeds and P. J. Weinberger, 'File Security and the Unix Crypt Command,' AT&T Bell 
Laboratories Technical Journal, 63 (19*4) 1673-1644 

-Encipherment cannot frustrate adversaries with super-user privileges. Cryptogames have other 
dangers too. The only useful application is in data transmission. 
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NAME 

number - convert Arabic numerals to English 

SYNOPSIS 

number 

DESCRIPTION 

Number copies the standard input to the standard output, changing each decimal number to a 
fully spelled out version. Punctuation is added to make the output sound well when plaved 
through speak(\). K • 

SEE ALSO 

speak(l) 
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NAM E dsw — delete interactively 

SYNOPSIS dsw [ directory ] 

DESCRIPTION For each file in the given directory J, . if not 

specified) dsw types its^name. If y is typed, 
the file is deleted; if x , dsw exits; if any- 
thing else, the file is not removed. 

FILES 

SEE ALSO rm 
DIAGNOSTICS "? " 

BUGS The name "dsw" is a carryover from the ancient 

past. Its etymology is amusing but the name is 
nonetheless ill-advised. 

OWNER dmr , Xen 
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NAME 

dd — convert and copy a file 

SYNOPSIS 

dd [option— value! ... 

DESCRIPTION 

Dd copies its specified input file to its specified output with possible conversions. The input and 
output block size may be specified to take advantage of raw physical I/O. 

option values 

if— input file name; standard input is default 

of— output file name; standard output is default 

ibs— input block size (default 512) 

obs- output block size (default 512) 

bs— set both input and output block size, superseding ibs and obs: also, if no conver- 
sion is specified, it is particularly efficient since no copy need be done 

cbs— n conversion buffer size 

skip— n skip n input records before starting copy 

count— n copy only n input records 

conv-ascii convert EBCDIC to ASCII 

ebcdic convert ASCII to EBCDIC 

lease map alphabetics to lower case 

ucase map alphabetics to upper case 

swab swap every pair of bytes 

noerror do not stop processing on an error 

sync pad every input record to ibs 

several comma-separated conversions 

Where sizes are specified, a number of bytes is expected A number may end with k, b or w to 
specify multiplication by 1024, 512, or 2 respectively. Also a pair of numbers may be separated 
by x to indicate a product. 

Cbs is used only if ascii or ebcdic conversion is specified In the former case cbs characters are 
placed into the conversion buffer, converted to ASCII, and trailing blanks trimmed and new-line 
added before sending the line to the output In the latter case ASCII characters are read into the 
conversion buffer, converted to EBCDIC, and blanks added to make up an output record of size 
cbs. 

After completion, dd reports the number of whole and partial input and output blocks. 

For example, to read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into 
the ASCII file x: 

dd if-/dev/rmtO of— x ibs-800 cbs— 80 conv-ascii, lease 

Note the use of raw magtape. Dd is quite suited to I/O on the raw physical devices because it al- 
lows reading and writing in arbitrary record sizes. 

SEE ALSO 

CP a) 

BUGS 

The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the CACM 
Nov, 1968. It is not clear how this relates to real life. 
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NAME 

faced — network face server 

SYNOPSIS 

/u«r/n«t/f ace . go 

DESCRIPTION 

The network face server provide* a database of 48x48 bit icons and other facial representations. It 
is implemented as a network file system similar to netfs (8) . 

The file system, conventionally mounted on /n/f ace, has a fixed three-level hierarchy. The first 
level is a machine name, the second level a user name, and the third level a resolution. Thus the- file 
/n/f *ct/kw««/p jv/4 8x48x1 is the standard face icon (for user pjw) on machine kwee 




Many local users also have 51 2x5 12 byte high-resolutioo faces, named 512x512x8. Other resolu- 
tions may also be present for a particular face. One- bit images are stored in the format used by 
icon (9. \); eight-bit images are arrays of bytes. The directories for machines sharing a user com- 
munity, such as those on a Datakit node, are linked together and given a name appropriate to the 
community. For example, /n/f aee/kvee is a link to /n/f ace/aatro. 

To access the face for a mail name machine l uid take the result of the first successful open from the 
following list of files: 

/n/face/aachine/uid/48x48x1 
/n/f ace/alac . /uid/48x48x 1 
/n/f ace/aachine/untaovn/48x48x 1 
/n/f ace/aisc . /unknovn/48x48x1 

The directory alec, holds faces for generic users such as root and uucp. The face server is made 
available on a machine by running /uar /net/face . go from re(8). 

The face server data is administered by a pair of ASCII Ales that associate related machines and 
faces. The machine table machine . tab attaches machines to communities; in it the line 

kvee»aetro 

puts machine levee in community astro. The people table people. tab associates a 
machine/user pair in the face server with s file in one of the source directories 
/uar/ jerq/icon/f ace48 or /tO/f ace/5 12x5 12x8 on kwee. Thus 

aatro/pjv«pjw«inb«rg«r 

causes the images stored in source files named pjvainbarger to be available in the face server in 
directory /n/f ace/aatro/pjw. As well, each disk file used by the face server is linked (by its 
original name) into the directory /n/fac«/48x48x1 or /n/f ace/5 12x5 12x8 for easy access to 
all the images. 

/n/Tcwee/uar/ jerq/icon/f ace48 directory of low resolution faces 

/n/kwee/tO/f aca/5 1 2x5 1 2x8 directory of high resolution faces 

/n/kvee/uar /net/f ace/paople . tab people/file equivalences 
/n/Tcwee/uar/net/f ace/machine . tab machine/community equivalences 

SEE ALSO 

netfs (8), face (9.1), mugj(9.1), icon (9.1), vismon (9.1) 

BUGS 

After updating the tables, an indeterminate time may pass before the new feces are available. 
All face server files are unwritable. 
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GLOSSARY 



This glossary covers major terms that have special meaning for the UNIX system. It excludes ordi- 
nary terms of art such as 'ASCII', 'compiler', 'address space', or 'byte'. It also excludes most terms 
peculiar to a single part of UNIX, e.g. 'diversion' (troff), 'enumeration' (C). or 'pattern space' 

(sed). 



i.oat the default name of a freshly compiled object 
flit, pronounced ' A-doi-out'; historically a. out signi- 
fied assembler output, 
akeoiote petbauw same as full pathname. 
atarai a signal scheduled by the clock, 
archive 1. a collection of data gathered from 
several files into one flic. 2. especially, such a col- 
lection gathered by ar(l) for use as a library. 
argaateat 1. a string made available to a process 
upon executing a file. 2. a string in a command. 
which the shell will pass to the command program 
as an argument ( 1 1. 
ASCII file same as text file. 

aetoceadc persistent only during the invocation of 
a procedure, said of data belonging to a process; 
automatic data occupies the stack segment: cf. 

static. 

backer oeo 4 running independently of a terminal, 
said of a process: converse of foreground. 
Mil vernacular name for a prototype Teletype S620 
terminal: cf. jerq. 

Meek the basic unit of buffering in the kernel. 
1024 or 4096 bytes in the 8th edition. 
Mock device a device upon which a file system I 1 ] 
can be mounted, typically a permanent storage dev- 
ice such as a tape or disk drive, so called because 
data transfers to the device occur by blocks: cf. 
character device. 

boos to sun the operating system, so called 
because the kernel must bootstrap itself from 
secondary store into sn empty machine. No login 
(31 or process persists across a boot, boat Mock 
the first block of a file system (I), which is 
reserved for a booting program, 
break I . an out-of-band signal oa aa asynchronous 
data line arisiaf from the "break' or 'interrupt' key 
on a terminal: before logging in a break causes a 
change in baud rata: thereafter it is interpreted as 
an interrupt. 2. a control statement in the C 
language. 3. the program break. 4. in troffi\). a 
point in running text where a new line must begin. 
BSD if UNIX. 



se segment. 

hotter i. a staging area for input-output where 
arbitrary-length transactions are collected into con- 
venient units for system operations; the file system 
[3 1 uses buffers, as docs stdio. 2. to use buffers, 
buffer peel a region of store available to the file 
system (3) for holding blocks: -'I but raw (21 
input-output for block devices goes through the 



buffer pool so read and write operations may be 

independent of device Mocks. 

ckroak a mode of terminal input in which every 

character not a special character becomes available 

to a read il) operation as soon as it is typed, 

instead of being buffered up to a newline or EOT 

character. 

ckaractar I. a unit of store, usually 8 Mts; s byte. 
2. a token of the ASCII code, with octal value 
between end 0177. 

character device a device upon which a file system 
[1] cannot be mounted, such as a terminal or the 
iull device. 

cMM sreceee sec for k. 

dose to make an open file unavailable for input or 
output: convene of open. 

ceoisaead 1. an instruction to the shell, usually to 
run s program I 1 1 as a child process. 2. by exten- 
sion, any executable file, especially s utility pro* 
gram, 

ceeaaaad ftte same as shell script. 
eeaerei character an ASCII character with octal 
code 0-037 or 0177, which does not print but may 
otherwise effect the behavior of a terminal: cf. spe- 
cial character. 

coatrei tertataai the terminal associated with a 
process from which the process may receive inter- 
rupt, qmt. and hangup signals: cf. process group. 
cooked not raw 111. said of an input stream (21 in 
which special characters are active, 
cookie a peculiar goodie, token, saying, or remem- 
brance returned by or presented to a program (3). 
core (He a core image of a terminated process 
saved for debugging; a core file is created under the 
name core' in the current directory of the process, 
core laaafe a copy of all the segments of a running 
or terminated program: the copy may exist in mam 
store, in the swap area, or in a core file. 
crease to open a file for writing, bringing it into 
existence as a plain file if necessary, and discarding 
any data it may have contained previously: cf. 
unlink. 

correal directory, workiag ssrectery the directory 
from which relative pathnames begin: a current 
directory is associated with each process. 
eoeeeoa a background process, often perpetual, 
that performs a system-wide public function, e.g. 
calendar U) and cron(t): the affected spelling is an 
ancient legacy. 

DatakK (tm) a virtual circuit switch for digital 
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,NTR0(9) INTR0(9) 



NAME 

intro - introduction to 5620-related software 
DESCRIPTION 

Section 9 of this manual lists software for running or supporting Teletype DMD-5620 terminals the 
current implementation of the 'jerq 1 graphics term.nals. Subsections 9.1-9.7 mirror the purposes of 
the preceding sections 1-7, with 9.1 being commands. 9.6 being games, etc. 

Few commands deal with a 5620 in native mode. 32ld(9.\) loads programs into the terminal and 
mux (9.1) starts the characteristic 'layer' or wmdow system. Almost all other commands in section 
9 either run on Unix or within mux layers. 

A layer is technically a virtual terminal, but is almost indistinguishable in software from a real ter- 
minal; ,n particular, the interface described in uyldU) applies to layers, except for the additional 
editing capabilities discussed in mux (9.1). 

The commands in sections 9.1 and 9.6 run on Unix, but most implicitly call 32ld to down-load a 
program that replaces the default terminal process running in the layer. To Unix the interface is 
still that of a terminal; in particular Idevttty is always connected to the layer. The default mux ter- 
m.nal program implements the teletype function itself. When a program is down-loaded a teletype 
line discipline is pushed on the stream (see stream(4) and ttyldiA)). Some commands may simply 
emulate other terminals by down-loading a terminal program (see term(9.\h others, such as the 
text editor wm(9.1). are really two programs - one on Unix and one in the layer - communicat- 
«ng using standard input/output on Unix and s«idchar( )/rcvchar< ) in the terminal; see 
request (9.2). 

There is an identity between bitmaps and layers in the graphics software. Graphic objects are bit- 
maps. The primitives that operate on layers are aliased to the bitmap primitives, and the data struc- 
tures are isomorphic. When running under mux. a programmer need not consider layers as graphi- 
cal objects at all; the operating system checks the arguments to the graphics primitives and 
dispatches the appropriate operator depending on the type of the argument. Except in stand-alone 
software, layers are an invisible implementation detail. 

FILES 

/uar/ jarq/bin jerq-related Unix object programs 

/uar/jarq/abin terminal programs, usually down-loaded automatically by programs in 
/uar/jarq/bin 

SEE ALSO 

32ld(9.\), micr(9.1). strtamU), pi (4) 



Ninth Edition 



September 22. 1986 
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Combined Tables of Contents 



The following table lists every manual page ever printed, with the editions it appeared in marked +. 
A number instead of a + mark indicates that the page appeared in a different chapter of that edi- 
tion. An appended name in brackets [ ] means that a manual page was later superseded or sub- 
sumed by the named page. 

Research software that was not included in distribution tapes was generally omitted from the v6 and 
v7 manuals. With v7 an addendum about unexported software was printed for local use; items from 
it are flagged L. 

Thus one can infer from the table that apl existed from v5 through v7, but was never distributed. 
In v5 it lived in chapter 6, "User maintained commands." It disappeared with v8, a casualty of the 
conversion from PDP-lls to VAXes. 

Trivial name changes are quietly ignored, e.g. a change from cons (A) in v8 to console (A) in v9 and 
from file system (V) in vl-v3 to fs(V) in v4-6 to filsys(5) in v7-v9. The short descriptions also 
changed from time to time; those given here are from v7 or else from the edition where the page 
first appeared. 



1. Commands 

Except for games, "user maintained commands" from chapter 6 of vl-v6 are included here with 
chapter 1, where they resided in later editions. 

Edition Title Purpose 
12 3 4 5 6 7 8 9 

+ + + intro introduction to commands 

. + + place label [goto] 

+ + ™ redo previous shell command 

+ 8 acct get connect-time accounting 

+ . + adb debugger 

+ . altran language for algebraic computation Hangs] 

. . . . 6 . L . . apl APL interpreter 

+ + apply apply a command to a set of arguments 

+ + apsend send troff output to aps-5 

+ + + + + + + + + ar archive and library maintainer 

+ . . arcv convert archives to new format 

+ + + + + + + + + as assembler 

+ . asa interpret ASA control characters 

+ + ascii interpret ASCII characters 

+ + + at execute commands at a later time 

+ + + awk pattern scanning and processing language 

6 6 6. . . azei obtain satellite predictions 

+ + + b compile b program 

+ backup backup and recover files 

++++6++. . bas basic [hoc] 

+ + + basename strip filename affixes 

6 6 + . basic . DEC supplied basic [langsl 

+ + + + be arbitrary-precision arithmetic language 

L . . bs a compiler/interpreter for modest-sized programs 

+ + bundle collect files for distribution 
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Edition Title 
12 3 4 5 6 7 8 9 

+ . bytcycars 

66 . 6 6 6 + + 7 cal 

+ + + calendar 

L . . call 

+ + can 

+++++++++ cat 
... +6 ... . catsim 

+ + + cb 

+ + cbt 

. ++++++++ cc 

+ . . cd 

. .++++. . . cdb 

L + . cflow 

++++++. . . chdir 
+++++++++ chmod 
+ + + + + 8+ 88 chown 

+cin 

+cite 

+ . clear 

+ + + + + + + + + cmp 
. . . .66 + . .col 

+ + column 

.... + + + + + comm 

+ . . con 

+ + coreid 

+ + + + + + + + + cp 

L + + cpio 

. 6 + + + + L . . cref 
. . + . . . + + 6 crypt 

+ + ct 

+ + + CU 

+ + cut 

+ + cyntax 

+ + d202 

6 6 das 

+ + + + + + + + + date 
+ + + + + +. . . db 

+ dbppt 

+ + + + + + + + + dc 

+ + dcon 

.... + + + + + dd 

+ + + deroff 

++ + 8 8 8 + + + df 
. . . . + + + + + diff 

++ . difD 

+ + dired 

6 6 8 dli 

+ + docgen 

+ + doctype 

6 6 dpt 

L . . draw 

. + ds 



Purpose 

time-space product for file residency 
print calendar 
reminder service 
ring a telephone 

interface to Cannon laser-printer spooler 

catenate and print 

phototypesetter simulator 

C program beautifier 

btree utilities 

C compiler 

change working directory [sh] 

C debugger [adb] 

generate C flow graph 

change working directory [cd] 

change mode 

change owner or group 

C interpreter 

process citations in a document 
clear terminal screen 
compare two files 
filter reverse line feeds [columnl 
column alignment 

select or reject lines common to two sorted files 
connect to another UNIX [dcon] 
identify source of a core image 
copy file 

copy file archives in and out 
cross-reference table 
encode/decode 

call terminal (and start a session) 
call Unix 

rearrange columns of text 

C syntax checker 

phototypesetter filters 

disassembler [adb] 

print and set the date 

symbolic debugger [adb] 

write binary paper tape [dump] 

desk calculator 

remote login and execution 

convert and copy a file 

remove nroff, troff, tbl and eqn constructs 

disk free 

differential file comparator 

3-way differential file comparison 

directory editor 

load DEC binary paper tapes 

generate a document from a script 

guess command line for formatting a document 

read DEC ASCII paper tapes 

edit a circuit diagram 

verify directory hierarchy 
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Edition Title 
12 3 4 5 6 7 8 9 

++++++. . . dsw 

+ dtf 

+ + + + + + + + + du 
. ++++++++ echo 
+++++++++ ed 

+ . en 

. . . . + + + + + eqn 
. +++++. . . exit 

+ + + expr 

+ + + f77 

. .+ + 66 + + + factor 
. + + + + +. . . fc 
. + + + + 6 . . . fed 

L . . fget 

. . . + . + + + + file 

+ + find 

.... + + + + + find 

+fmt 

+ for 

+ + + + + 6 L . . form 

. . + forml 

L . . fsend 

L . . gcat 

+ + getuid 

L . . gex 

+gone.fishing 

. + + + + +. . . goto 
.... 6 ... . graf 

+ + grap 

6 + + + graph 

L . . greek 

. . . + + + + + + grep 
.... 6 6 ... gsi 

+ + hang 

+ + hoc 

L . . huff 

+ hup 

..+66.... hyphen 
. . . . 6 . L . . ibm 

+ . icont 

+ + ideal 

. , + + idiff 

. + + + + +. . . if 

L . . iget 

+ + . iostat 

L . . isend 

+ + + join 

. . 8 + + + + + + kill 

L+ + lab 

+ langs 

. . + . last 

+ lbppt 



Purpose 

delete files interactively [rm] 
format DEC tape 
summarize disk usage 
echo arguments 
text editor 

extended Fortran language preprocessor 

typeset mathematics 

end command sequence [shl 

evaluate arguments as an expression 

Fortran 77 compiler 

factor a number, generate large primes 

compile Fortran program [f77] 

form-letter editor [form] 

retrieve files from HIS 6000 

determine file type 

find file with a given name 

find files 

ultra-simple text formatter 
compile fortran program [fc] 
generate form letter 
generate form letters 
send files to HIS 6000 

send phototypesetter output to HIS 6000 [apsend] 
get user identity 

graphics exerciser for Tektronix 4014 

automatic reply to mail 

command transfer [sh] 

draw graph on GSI terminal 

pic preprocessor for drawing graphs 

draw a graph 

interpret extended character set 

search a file for a pattern 

interpret funny characters on GSI terminal 

start a process in stopped state 

interactive floating point language 

Huffman code file compression [pack] 

hang up typewrite 

find hyphenated words 

submit off-line job to HO IBM 370 

Icon language translator and compiler 

troff preprocessor for drawing pictures 

interactive file comparison 

conditional command [sh] 

get files from Holmdel IBM 370 

report I/O statistics [load] 

send files to Holmdel IBM 370 

relational database operator 

terminate a process with extreme prejudice 

label maker 

altran, basic, ... languages 
report recent logins [who] 
read binary paper tape [restor] 
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Edition Title 
12 3 4 5 6 7 8 9 

+ + lcomp 

+++++++++ Id 

L . . lde 

■. + + + learn 

+ + + lex 

+ + + lint 

+ . lisp 

+ + + + + + + + + In 

+load 

. + + + + + + 88 login 

+ + + look 

+ . . lookall 

+ . + lorder 

. . . . + . + + + lpr 
+ + + + + + + + + Is 

+ + + m4 

.+ + 6 6 6. . . m6 

+ + Mail 

+ + + + + + + + + mail 

+ + + make 

. + + + + + + + + man 

+ . matlab 

. . . + merge 

+ + + + + + + + + mesg 

+mk 

+ + + + + + + + + mkdir 

+mkpkg 

+monk 

. + + mt 

+++++++++ mv 
....++... neqn 

+ + newer 

+ + + + newgrp 

+ + news 

L . . nfs 

. . . + + + + + + nice 

+ + + + + + + + + MX1 

...+ + +... nohup 
.... 6 .... npr 
. + + + + + . . . nroff 

L + 6 number 

+,+ + + + + + + + od 
.+ + + + + L .. opr 
. + + 6 ov 

+ + P 

+ + pack 

+ . paper 

+ + pascal 

. . + + + + + + + passwd 

.+ PC 

. . . + + + : . . pfe 
+ + pic 



Purpose 

line-by-line profiler 
loader 

logic design equation language 
computer aided instruction about UNIX 
generator of lexical analysis programs 
a C program verifier 
lisp interpreter and compiler [langs] 
make a link 

load and input-output statistics 
sign on 

find lines in a sorted list 

look through all text files on UNIX 

find ordering relation for an object library 

line printer spooler 

list contents of directory 

macro processor 

macroprocessor [m4] 

send and receive mail 

send or receive mail among users 

maintain program groups 

print sections of this manual 

interactive matrix desk calculator [langs] 

merge several files [sort] 

permit or deny messages 

maintain (make) related files 

make a directory 

make and install packages 

typeset documents and letters 

save/restore files on magtape [tar] 

move or rename files and directories 

typeset mathematics on a terminal [eqn] 

test file modification dates 

log in to a new group 

print news items 

communicate with Spider File System 
run a command at low priority 
print name list 

run a command at low priority [nice] 
print file on Spider line-printer 
format text for printing [troff] 
convert Arabic numerals to English 
octal dump 
print file off-line 
page overlay file print 
paginate 

compress and expand files 

list input on HP2621P printer 

language interpreter 

instail new password or user 

pascal language compiler 

print floating exception 

troff preprocessor for drawing pictures 
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Edition Title 
12 3 4 5 6 7 8 9 

+ . pick 

L . . place 

.... 6 ... . plog 
. . . +66+ + + plot 

+ . post 

+ + + + + + + + + pr 
+ prefer 

+ ■ • P^P 

6 . . . primes 

.... + + + + + prof 

L . . prom 

. . + + proof 

, . 8 + + + + + + ps 
. 6 6 6 6 . + + + ptx 

+ . . pubindex 

+ + push 

.... + + + + + pwd 

+ • P*P 

+ + random 

+ . ranlib 

+ + + . ratfor 

+ + + refer 

+ + + + rev 

+ + + + +. . . . rew 

+ . . rkd 

+ rkf 

+ rkl 

+ + + + + + + + + rm 
+ + + + + +. . . rmdir 
+ + + + + + +. . roff 

+ + ropy 

+ rscan 

+ sdate 

+ + sdb 

L . . sdiff 

+seal 

+ + + sed 

+ sendcover 

+ + scq 

+ + server 

.... 6 .... sfs 
+ + + + + + + + + sh 
. . + + + + . . . shift 

+ + ship 

. . + + + + + + + size 
. . . 6 6 6 L 7 7 sky 
. . . + + + +- + + sleep 
. . + + 6 6 L + . sno 

+ + snocone 

6 + + + + + + + + sort 
. . + + 6 6 L . . speak 
. . . . + + + + + spell 



Purpose 

pick arguments [apply] 

design physical layout of a circuit 

make a graph on the gsi terminal 

graphics filter 

send mail to users by name 

print file 

maintain and use bibliographic references 
prepare text for statistical processing 
print all primes larger than somewhat [factor] 
display profile data 

read and write proms through the PROLOG promwriter 
compare text files [diff] 
process status 
permuted index 

make inverted bibliographic index [refer] 
datakit remote file copy 
working directory name 

pascal printer, profiler, and cross-reference lister 
sample lines from a file or provide random exit code 
convert archives to random libraries [ar] 
Ratfor compiler [langs] 

find and insert literature references in documents 

reverse lines of a file 

rewind DECtape 

dump disk to tape 

format RK disk 

load disk from tape 

remove (unlink) files 

remove (delete) directory [rm] 

format text 

remote file copy for arpa internet 

scan pages on ricoh scanner and display on 5620 

adjust date and time [date] 

symbolic debugger 

side-by-side difference program 

mailable data file 

stream editor 

send cover sheet to the library 

print sequences of numbers 

run anonymous command on another machine 

structured file scanner 

command language 

adjust shell arguments [sh] 

automatic software distribution 

size of an object file 

obtain ephemerides 

suspend execution for an interval 

compile Snobol programs [langs] 

snobol with syntactic sugar 

sort or merge files 

send words to voice synthesizer 

find spelling errors 
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Edition Title 
12 3 4 5 6 7 8 9 

+ . spitbol 

. . .6 6 6 + . . spline 
. . + + + + + + + split 

+ + + stat 

+ + + + + + + + + strip 

+ + . struct 

. + + -t- + + + + + stty 
+++++. + + + sum 

+ + + tabs 

+ + + tail 

+ + + tap 

+ + tape 

+ + + tar 

6 + + + tbi 

+ . . tc 

. . . .+++++ tee 

L . . tekstare 

+ . telnet 

+ + + test 

+ tex 

. . + + + + + + + time 

+ + . tk 

. 6 + 6 6 6 L . . tmg 

+ + + touch 

. . .++++. . tp 
. . . + + + + + + tr 

+ + trace 

+ . track 

. . . ++++++ troff 

+ + + true 

+ . tset 

+ + + tsort 

. + + + + . L . . tss 
+++++++++ tty 

+ + + + type 

. . ++++L . . typo 

L . . ufs 

+ + ul 

+ + + un 

. . + + + + + + + uniq 

6+77 units 

....+... usort 

+ + + uucp 

L . . uudiff 

+ + uustat 

+ + + UUX 

L . . vc 

+ + vi 

+ + view2d 

+ + vis 

+ . visi 

. . + vs 



Purpose 

Snobol language compiler [langs] 
interpolate smooth curve 
split a file into pieces 
get file status 

remove symbols and relocation bits 

structure Fortran programs 

set terminal options 

sum and count blocks in a file 

set terminal tabs 

deliver the last part of a file 

manipulate DECtape 

identify and manipulate magnetic tape 

tape archiver 

format tables for nroff or troff 
troff output interpreter 
pipe fitting 

convert tektronix picture to hard copy graphics [can] 

user interface to the telnet protocol 

condition command 

text formatting and typesetting 

time a command 

paginator for the Tektronix 4014 

compile tmgl program 

update date last modified of a file 

manipulate tape archive [tar] 

translate characters 

protocol compiler and analyzer 

selective remote file copy 

text formatting and typesetting 

provide truth values 

set terminal modes 

topological sort 

communicate with MH-TSS (GCOS) 

get terminal name 

print file on IBM 2741 

find typographic errors 

Spider Network Communication 

print underlines on screen terminals 

fine undefined symbols 

report repeated lines in a file 

conversion program 

sort and merge files, discarding duplicate lines [sort] 
unix to unix copy 

directory comparison between machines 

uucp status inquiry and job control 

unix to unix command execution 

verification of tests for C programs [lcomp] 

screen oriented (visual) display editor based on ex 

movie of a function f(x,y,t) 

show invisible characters 

mathematical spreadsheet 

generate voice synthesizer phonemes 
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Edition Title 
12 3 4 5 6 7 8 9 

. . .++++. . wait 
+++++++++ wc 

L . . wcheck 

+++++++++ who 

L . . wrap 

+++++++++ write 

+ + wwb 

+ + wwv 

L . . xref 

+ + . xsend 

. .6 6 6 + + + + yacc 

2. System calls 

Edition Title 
12 3 4 5 6 7 8 9 

+ + + + + intro 
. . + + + access 
. . + + + acct 
. . + + + alarm 
. . . + . boot 
+ + + + + +. . . break 

+ + + cemt 

+ + + + + + + + + chdir 
+ + + + + + + + + chmod 
+ + + + + + + + + chown 
+ + + + + + + + + close 
+ + + + + + + + + creat 
. .+ + + +. . . csw 

+ deprecated 

. . + + + + + + + dup 
+ ■*- + + + + + + + exec 
+ + + + + + + + + exit 

+fmount 

+ + + + + + + + + fork 

• . + f pe 

+ + + + + +. . . fstat 
. . . + + + . . . getgid 

+ + . . getpid 

+ + + + + + + + + getuid 

+ . gmount 

gtty 
hog 
i I gins 
indir 
intr 



++++++ . 

. + 



. . . ++++ . 

+ + + 

+ + + ioctl 

. + + + + + + + + kill 
+ + + + + + + + + link 

+ . . lock 

+ + + lseek 

+ + + +mkdir 

. . . + + + + + + mknod 



Purpose 

await completion of process [sh] 
word count 

look for inconsistencies in a circuit description 
who is on the system 

generate control information for wiring a circuit board 
write to another user 
writers workbench 

print and set the date from accurate clock 
cross reference for C programs 
secret mail 

yet another compiler-compiler 



Purpose 

introduction to system calls and error numbers 

determine accessibility of file 

turn accounting on or off 

schedule signal after specified time 

reboot the system 

set program break [brk] 

catch EMT traps [signal] 

change default directory 

change mode of file 

change owner and group of a file 

close a file 

create a new file 

read the console switches 

system calls to be avoided 

duplicate an open file descriptor 

execute a file 

terminate process 

mount or remove file system 

spawn new process 

catch floating exception errors [signal] 

status of open file [stat] 

get group identification [getuid] 

get process identification [getuid] 

get user and group identity 

mount or remove non-standard file system [fmount] 

get typewrite mode [ioctl] 

set low-priority status [nice] 

catch illegal instruction trap [signal] 

indirect system call [syscall] 

catch or inhib interrupts (signal] 

control device 

send signal to a process 

link to a file 

lock a process in primary memory 
move read/write pointer 
create directory 

make a directory or a special file 
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Edition Title 
12 3 4 5 6 7 8 9 

+ + + + + + + +. mount 

+ . . mpx 

. . + + + + + + + nice 
+ + + + + + + + + open 

+ + . pause 

+ . . phys 

. . + + + + + +. pipe 

+ . . pkon 

, . . . + + + + + profil 

+ + + . ptrace 

+ + + quit 

+ + + + + + + + + read 

+ + + rele 

+ + + + + +. . . seek 

+ + select 

. . . + + + . . . setgid 
+ + + + + + + + + setuid 
. . . + + + + + + signal 
. + + + + +. . . sleep 

+ + + smdate 

+++++++++ stat 
+ + + + + + + + + stime 
++++++. . . stty 
. + + + + + + + + sync 

+ + syscall 

+ + tell 

+ + + + + + + + + time 
. . + + + + + + + times 

+ + - umask 

++++++. . . umount 
+++++++++ unlink 

+ + + utime 

+++++++++ wait 
+++++++++ write 

3. Subroutines 

Edition Title 
12 3 4 5 6 7 8 9 

+ + + intro 

+ + + + abort 

++ . . abs 

.\ . . + + . . . alloc 

+ + arith 

+ + + assert 

.+ + + + +. . . atan 
+ + + + + + + + + atof 
+ + + . . + . . . atot 
.......... + + cbt 

+ + chrtab 

. . + + compar 

. + const 

7 L . . cr 



Purpose 

mount or remove file system [fmount] 

create and manipulate multiplexed files 

set program priority 

open for reading or writing 

stop until signal [alarm] 

allow a process to access physical addresses 

create an interprocess channel 

establish packet protocol 

execution time profile 

process trace [proc(4)l 

catch or inhibit quits [signal] 

read from file 

release processor 

move read or write pointer [lseek] 
synchronous I/O multiplexing 
set process group ID [setuid] 
set user and group ID 
catch or ignore signals . 
delay execution [alarm] 
set date modified of file [utime] 
get file status 
set time 

set mode of typewriter [ioctl] 

update super-block 

indirect system call 

find read or write pointer [seek] 

get date and time 

get process times 

set file creation mode mask 

dismount file system [mount] 

remove directory entry 

set file times 

wait for process to terminate 
write on a file 



Purpose 

introduction to library functions 
generate IOT fault 

integer absolute value, sign function [arith] 

core allocator [malloc] 

integer arithmetic functions 

program verification 

arctangent [sin] 

convert ASCII to numbers 

convert ASCII to integer [atof] 

compressed B-tree subroutines 

simple character bitmaps 

string compare for sort 

floating point constants 

coroutine scheme 
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Edition Title 
1 2 3 4 5 6 7 8 9 

. . + ■+• + + + + + crypt 
+ + + + + + + + + ctime 

+ + + ctype 

+ + curses 

+ + + dbm 

. . + ddsput 

+ + dialout 

+ + directory 

+■ . dkmgr 

. . + + + + + + + ecvt 

+ + + + end 

L + + erf 

+ + + + + + + + + exp 

+ + + fclose 

+ + + ferror 

+ fio 

.... + + + + + floor 

+ . . . fmod 

+ + + fopen 

+ + + + + +. . . fptrap 

+ + + fread 

+ + + frexp 

+ + + fseek 

+ + + ftoa 

. . + ftoo 

+ + ftw 

L + + galloc 

. . . . + + L + + gamma 
. + + + . . . gerts 
. . . .++.+ + getarg 
+ + + + + + + + + getc 
. . . + + + . . . getchar 

+ + + getenv 

+ getfields 

+ + getfsent 

+ + + getgrent 

+ + + getlogin 

+ + getopt 

+ + + getpass 

. . .++++. . getpw 

+ + + getpwent 

+ + + gets 

+ + getwd 

. . . + + + . . . hmul 
. + + + + . + + + hypot 
. . , +++ . . . ierror 

+ internet 

+ipc 

+ + + itoa 

+ + +j0 

+ + + 13tol 

. . . + + + . . . ldiv 



Purpose 

DES encryption 

convert date and time to ASCII 

character classification 

screen functions with 'optimal' cursor motion 

data base subroutines 

display characters on Picturephone 

place call on ACU 

directory operations 

establish datakit server 

output conversion 

last locations in program 

error function 

exponential, logarithm, power, square root 
close or flush a stream 
stream status inquiries 
fast buffered I/O 

absolute value, floor, ceiling functions 

floating modulus function [floor] 

open a stream 

floating-point simulator 

buffered binary input/output 

split into mantissa and exponent 

reposition a stream 

convert floating to ASCII [ecvt] 

convert floating to octal 

file tree walk 

storage allocation with garbage collection 

log gamma function 

communicate with GCOS 

get command arguments from Fortran 

get character or word from stream 

read character [getc] 

value for environment name 

break a string into fields 

get file system descriptor file entry 

get group file entry 

get login name 

get option letter from argv 

read a password 

get name from UID 

get password file entry 

get a string from a stream 

get current directory 

high-order product 

euclidean distance 

catch Fortran errors 

internet networking functions 

set up communications between unrelated processes 

convert integer to ASCII 

bessel functions 

convert between 3-byte integers and long integers 
long division 
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Edition Title 
12 3 4 5 6 7 8 9 

7 liba 

7 libb 

7 libf 

.,..++,.. locv 
+ + + + + +. . . log 

+ + + malloc 

L + + map 

+ + memory 

+ + + + mesg 

+ + + mktemp 

. . . .+ + + + + monitor 

+ + + mp 

. . . + + + . . . nargs 



. + + + + + + + + nlist 
. . . + + + + + + perror 

+ . . pkopen 

7 + + + plot 

+ + + popen 

+ + port 

. .++++. . . pow 

+ print 

. . . + + + + + + printf 

+ + + ptime 

+ + ptopen 

+ + + + + + + + + putc 
. . . + + + . . . putchar 

+ + + puts 

. + + + + + -t- + + qsort 
. . + + + + + + + rand 

+ • regex 

+ + regexp 

. . + + + . . . reset 
. + + . . 7 L . . salloc 

+ + + scanf 

+ + + setbuf 

. . . + + + . . . setfil 

+ + + setjmp 

+ + + + + + + + + sin 

+ + + sinh 

+ + + sleep 

. + + + + +. . . sqrt 

\ + + + stdia 

+ + + string 

+ + + swab 

+ + + + switch 

+ + + system 

+tcp 

L + + tdkdial 

+ + termcap 

+ + tolower 

. . + + + + + + + ttyname 
+udp 



Purpose 

standard assembly-language library 

standard B library 

standard Fortran library 

long output conversion [printf] 

logarithm base e [exp] 

main memory allocator 

map projections 

memory operations 

print string on typewriter [printf] 

make a unique file name 

prepare execution profile 

multiple precision integer arithmetic 

argument count 

get entries from name list 

system error messages 

packet driver simulator 

graphics interface 

initiate I/O to/from a process 

mathematical library for Fortran 

take powers of numbers texpl 

print formatted output 

output formatters 

print time 

find and open a pseudo-terminal file 
put character or word on a stream 
write character [putel 
put a string on a stream 
quicker sort 

random number generator 
regular expression handler [regexpl 
regular expression handler 
execute non-local goto [setjmp] 
string allocation and manipulation 
formatted input conversion 
assign buffering to a stream 
specify Fortran file name 
non-local goto 
trigonometric functions 
hyperbolic functions 
suspend execution for interval 
square root [expl 

standard buffered input/output package 
string operations 
swap bytes 

transfer depending on value 

issue a shell command 

tcp networking functions 

open a datakit connection to a remote server 

terminal independent operation routines 

force upper or lower case 

find name of a terminal 

udp networking functions 
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Edition Title 
12 3 4 5 6 7 8 9 

. . +uname 
+ + + ungetc 
. 4- + varargs 
. + + view2d 

+ + . . . . vt 



Purpose 

get password file entry 

push character back into input stream 

variable argument list 

movie of a function f(x,y,t) 

display (vtOl) interface 



4. Special files 

Terminology changed often in this section. In v3 mnemonic names were replaced by names of DEC 
devices, for example, tty became kl, ttyO became dc, and ppt became pc. The more recent names 
are used here. Lately the trend has reversed, with the appearance of drum and cons. 

Edition Title Purpose 

12 3 4 5 6 7 8 9 

+ + bufld buffering line discipline 

. . .+ + + +. .cat phototypesetter interface 

+ connld connection line discipline 

+ + cons console interface 

. . . + da voice response unit 

++++++. . . dc remote typewriter 

....++... dh DH-11 communications multiplexor 

L + + dk Datakit interface 

. + + + + + +. . dn DN-ll ACU interface 

.+ + + + +... dp 201 dataphone 

+ + drum paging device 

+ . . du DU-11 201 data-phone interface 

+ + fd file descriptor file 

+ + . . hp RH-1 1/RP04, RP05, RP06 moving-head disk 

+ + . . hs RH1 1/RS03-RS04 fixed-head disk file 

++. . ht RH-ll/TU- 16 magtape interface 

++++++. . . kl console typewriter [cons] 

. + . . + + L + . Ip line printer 

+ + + + + + + +. mem core memory 

+ + mesgld message line discipline 

. + + + + + + + + mt magtape interface 

+ . + + null data sink [mem] 

+ + + + + +. . . pc punched paper tape 

+ . . pk packet driver 

+ + proc process file system 

+ + pt interprocess I/O junctor files 

+ + ra DEC MSCP disks (RA60, RA80, RA81) 

+ + + + + + +. .rf RF1 1/RS1 1 fixed-head disk file 

+ + + + + + + +. rk RK-U/RK03 or RK05 disk 

:.+ .+ + + +.. rp RP-1 1/RP03 moving-head disk 

+ + stream stream I/O control calls 

+ + + + + + +.. tc TC-11/TU56 DECtape 

. . . + + . L . . tiu Spider interface 

. . . .+ + +.+ tty general terminal interface [ttyld] 

+ + ttyld terminal processing 

+ . . vp Versatec printer-plotter 

. . . + + . L . . vs voice synthesizer interface 
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Edition Title Purpose 
12 3 4 5 6 7 8 9 

. . + + + .. . . . vt storage-tube display 

5. File formats and conventions 

In vl-v5, section 5 was restricted to "File formats" 

Edition Title Purpose 
12 3 4 5 6 7 8 9 

+++++++++ a.out assembler and link editor output 

+ + + acct execution accounting file 

+■ + + + + + + + + ar archive (library) file format 

+ backup incremental backup file 

+ bppt binary paper tape format 

+config system configuration files 

+++++++++ core format of core image file 

+ cpio format of cpio archive 

+ + + + + + + + + dir format of directories 

. . . . + + + . . dump incremental dump format 

+ + + environ user environment 

+ + + + + + + + + filsys format of file system volume 

+ + fstab static information about the file system 

+ + + + group group file 

. + ident GCOD ident cards 

+ + map digitized map formats 

+ . . mpxio multiplexed i/o 

. . . .+ + + + + mtab mounted file system table 

+ + netnews USENET network news article, utility files 

+ ■ newsrc information file for readnews 

+ + + +++ + + + passwd password file 

7 + + + plot graphics interface 

+ poly polyhedra database format 

....+.... speak.m voice synthesizer vocabulary 

+ + stab symbol table types 

L . . tar format of tar archive 

+ + termcap terminal capability database 

. + + + + + +. . tp DEC/mag tape formats 

. . . .+ + + + + ttys terminal initialization data 

+ + types primitive system types 

+ + uids map names to user ID's 

+++++++++ utmp login records 

+ + view 2d movie of a function f(x,y,t) 

4* + whoami computer name 

*+++++. . . wtmp accounting files [utmpj 

6. Games 

In vl through v6 chapter 6 was called "User maintained maintained programs." Only the games 
from those editions are listed here; other pages from those chapters 6 are listed with chapter 1 or 
chapter 7. 

Edition Title Purpose 
12 3 4 5 6 7 8 9 

L + + adventure dungeon-exploration game 

+ + + arithmetic provide drill in number facts 

+ + ate air traffic controller 
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Edition Title Purpose 

12 3 4 5 6 7 8 9 

+ + + backgammon the game 

+ + + banner make long posters 

1 + + + bed convert to antique media 

+ + + + + + +.. bj the game of black jack 

+ + boggle word games 

+ + bridge card game 

+ + cards card games 

+ . . checkers game 

+ . .+ + + +. . chess the game of chess 

+ + ■ ching the book of changes and other cookies 

. . . + + + . . . cubic three dimensional tic-tac-toe 

+ + doctor psychiatric consultation 

+ festoon memo writer 

+ + fortune cookies 

+ . . . king the game of king 

. . .++.+. . maze generate a maze problem 

+ + • + + + + . . moo guessing game 

L . . morse convert letters to morse code 

1 + netnews sen dor receive news article 

L . . psych pattern generators 

-t- + + + quiz test your knowledge 

+ . . reversi a game of dramatic reversals 

+ + snake display chase game 

L + + trek war games 

+ +. + + + + . . ttt tic-tac-toe 

+ . . words word games [boggle] 

+ + worms silly demos 

. . . .+■ + +. . wump the game of hunt-the-wumpus 

7. Data bases and language conventions 

Like chapter 6, chapter 7 has been a catch-all, with various names over the years: 

vl-v5 Miscellaneous 

v6 User maintained subroutines 

v7 Conventions 

v8-9 Data bases and language conventions 

Edition Title Purpose 

12 3 4 5 6 7 8 9 

+ + apnews present ap wire stories 

+ + + + + 5 + + + ascii map of ASCII character set 

+. candest canon laser printers (can(l)l 

v L . . cdl circuit description language 

+ + dict look up words in English dictionaries 

+ + + eqnehar special character definitions for eqn 

+ + font typesetter fonts 

. . + + + 5 + . greek graphics for extended HdY-37 type-box 

+ . . hier file system hierarchy 

+ + kbd map of HdY 37 keyboard 

+ latex tex macro packages and bibliographies 

+ + library • bell labs library service 

+ + login logging on and logging off the system [how to get started! 

+ + mail address conventions and rewrite rules 



Ill 



Edition Title 
12 3 4 5 6 7 8 9 

+ + + man 

L + + map 

+ mbits 

+ + mcs 

+ + + + ms 

+ netnews 

+ papers 

+ poiy 

1 + postnews 

1 +readnews 

+ scat 

+ submit 

+ suftab 

+ + + + + 5 . ■ • tabs 

+ + tel 

+ . telno 

+ + . terra 

...++.... tmheader 

+ + town 

+ + troff 

. . + + + . L . . vsp 
+ + weather 



Purpose 

macros to typeset manual 

draw maps on various projections 

macros for typesetting bitmaps 

macros for formatting cover sheets 

macros for formatting manuscripts 

recent articles, utility files 

browse database of locally authored papers 

database of polyhedra 

submit netnews articles 

read news articles 

sky catalog 

install document in database 
roffs suffix table 

set tab stops on typewriter [tabs(l)l 
local and private telephone books 
retrieve from bell labs phone book [tel] 
conventional names 
TM cover sheet 
gazetteer of US places 
addenda to troff manual 
voice synthesizer phonemes 
conditions and forecast by town 



8. Maintenance commands and procedures 

Pages from chapter 1 of vl, v2, and v7 that appeared in chapter 8 of other editions are included 
here. In vl and v2 there was no chapter 8 and in v7 many system maintenance commands were 
placed in chapter 1, with the identification "1M". 

Chapter 8 is the most turbulent part of the manual: maintenance procedures, being known only to a 
few, and often being embedded in just one or two shell scripts may be more lightly changed than 
mainstream facilities. Moreover, much of chapter 8 is concerned with hidden procedures that are 
usually invoked automatically. 

It has alway been problematic just how much to say about such changeable things that so few peo- 
ple need to know about. Maintenance programs may remain "unofficial" for years. For example, 
one or another version of findo, for scouring trash out of full file systems, had existed since the ear- 
liest days, yet it was not documented until v8. 



Edition Title Purpose 

123456789 

+ +11 pdpl 1 support 

17+ + +. . . . 20boot rebooot 11/20 system 

....++ 1 + + ac login accounting 

+arff read RT11 files 

7 as2 assembler's pass 2 

+ + asd automatic software distribution 

7 ba B assembler 

+ backup backup administration 

7 be B compiler 

1 bilib B interpreter 

7 7+ + + + +. . boot .startup procedures [reboot] 

7 brtl,brt2 B start and finish 

• 6 chash prepare symbol table 

1 1 + + + . . . . check check consistency of file system [icheck] 
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Edition Title 
12 3 4 5 6 7 8 9 

+ . . . chgrp 

. . + chk 

. . 1 + + + 1 + + clri 

+ + cpp 

+ + . . crash 

+ + + + cron 

..+..+ 1 . . dcheck 

+ + dmesg 

. 1 7 7 + + L . . dpd 
....++ 1 . . dump 

1 . . dumpdir 

7 fl.f2.f3.f4 

L . . fgct.demon 

+ + finddcv 

+ + findo 

+ + fsck 

.7 7 7 + + + + + getty 
7 7 7 7 ++. . . glob 

+ 1 + + icheck 

7 7 7 7 + + + + + init 

. . . + ino 

. 1 + istat 

+ldpcs 

. . . . + + L + + lpd 

+ + + makckcy 

+mgrproc 

1 . . mkconf 

1 . . + + + 1 + + mkfs 
...+ + + 1 + + mknod 
1 1 + + + + 1 + + mount 
7 7 7 7 + . . . . msh 

+ 1 . . ncheck 

+ + netfs 

+ + netstat 

+ + oops 

1 + + pstat 

1 + + quot 

+ + rarepl 

+ + rc 

+ + reboot 

. . 1 + + . . . . reloc 

+ + renice 

. . + + 1 . . restor 

+ . rmdir 

....++ 1 + + sa 

. 1 + salv 

+ + savecore 

+ + showq 

+ smash 

1 1 + + + + 1 + + su 

+ + swapon 

. . . + + +1 + + sync 



Purpose 

change group [chown] 
check all file systems 
clear i-node 

C language preprocessor 

what to do when the system crashes 

clock daemon 

file system directory consistency check [icheck] 

system diagnostic messages 

dataphone daemons 

incremental file system dump 

print the names of files on a dump tape 

Fortran compiler passes 

fget daemons 

find process using a device 
find objectionable files 

file system consistency check and interactive repair 

set typewriter mode 

argument expander 

file system storage consistency check 

process control initialization 

get the i-number of a file 

file status by i-number 

load correct microcode 

line printer daemon 

generate encryption key 

service remote computing requests 

generate configuration tables [config] 

construct a file system 

build special file 

mount and dismount file system 

mini Shell 

generate names from i-numbers [icheck] 
network file system 

show network status for ARPA internet 

process status 

print system facts 

summarize file system ownership 

replace bad blocks on MSCP drive 

boot script 

bootstrapping procedures 
relocate object files 

alter priority of running process by changing nice 

incremental file system restore 

unlink directory 

system accounting 

repair damaged file system 

save a core dump of the operating system 

state of stream I/O system 

rewrite bad disk sectors 

substitute user id temporarily 

specify paging/swapping device 

update the super block 
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Edition Title Purpose 

12 3 4 5 6 7 8 9 

11+ tm get time information 

1 1 + + + +. . . umount dismount removable file system [mount! 

+ + upas address driven mailer 

■ . - ++++++ update periodically update the super block 

+ + uucheck check uucp directories and permissions file 

+ + uucico file transport program for the uucp system 

L + + uuclean uucp spool directory cleanup 

+ . uusched uucp file transport scheduler [uucico] 

+ + uuxqt create remote command requests 

+ + vmstat report virtual memory statistics 

+ 1 + + wall write to all users 

+ . xstr preprocessor for sharing strings in C programs 

9. Teletype 5620-related software 

Edition Title Purpose 

12 3 4 5 6 7 8 9 

+ + intro introduction to jerq-related software 

9.1 Commands 

+ + 321d bootstrap loader for the 5620 

+ + 3cc MAC-32 compiler for the 5620 

+ + blitblt make hard copy image 

+ brush painting program 

+ + cip picture drawing program 

+ + face show faces on a jerq 

+ flicks movie graphics for 5620 

+ getfont replace terminal's default font 

+ + graphdraw edit (combinatoric) graph 

+ + icon icon editor 

+ +jf font editor 

+ • jim text editor [sam] 

jerq execution and stdio interpreter 

+ + lens bitmap magnifier 

+ + mugs convert gray-scale images into icons 

+ + mux layer multiplexor for the jerq 

+ + paint draw pictures in a layer 

+ + ped picture editor 

+ + pi process inspector 

+ + pico graphics editor 

+ + proof troff output interpreter for jerq 

+ pvmon gray-scale picture preview window for 5620 

+ reader examine typeset documents 

• *• + + rebecca graphics touch-up editor 

+ + niler measure things on the screen 

+ sam screen editor with structural regular expressions 

+ + term nonstandard mux terminals 

+ + thinkblt print on ThinkJet 

+ + vismon system statistics and mail notification 

+ + windows create and initialize windows 

9.2 System calls 

The shortness of this subchapter and the next belies the comprehensiveness of the mux operating 
system. Descriptions were combined to save pages: the four pages of 9.2 document some three 
dozen system calls. 
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Edition Title Purpose 

1 2 3 4 5 6 7 8 9 

+ + button mouse control 

+ + newlayer layer control and graphics 

+ + newproc jerq process control 

+ + request jerq I/O requests 

9.3 Subroutines 

+ + add arithmetic on points and rectangles 

+ + alloc allocate memory 

+■ + bitblt basic jerq graphics functions 

+ + circle circle drawing functions for jerq 

+ + cos integer math functions 

+ + menuhit present user with menu and get selection 

+ + string jerq text and font operations 

+ thinkclient ThinkJet routines 

9.4 Devices 

++jioctl jerq ioctl requests 

+ + mouse jerq mouse interface 

9.5 File formats and conventions 

+ + bitfile format of bitmap file 

+ + faced network face server 

+ + font jerq font layouts 

+ movies graphics movie file formats 

+ + pads user interface package 

....... + + types basic jerq graphics data types 

9.6 Games 

+ + crabs graphical marine adventure game 

+ + demo graphic demonstration and games 

+ gebaca get back at corporate america 

r menudrop leave a menu lying around 

+ + pen doodle anywhere on the screen 

+ pengo squash the sno-bees 

+ + twid dabble in oils 

9.7 Data bases 

+ + blitmap map plots and path finding on a jerq 
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